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OFFERING PERIOD SERVICES 

During ft specified number of months immediately following 
initial availability of each licensed program, designated 
as the Offering Period, the customer may submit documentation 
to a designated IBM location when he encounters a problem 
which his diagnosis indicates is caused by a licensed program 
error. During this period only, IBM through the program 
author(s) will, without additional charge, respond to an 
error in the current unaltered release of the licensed program 
by issuing known error correction information to the customer 
reporting the problem and/or issuing corrected or notice of 
availability of corrected code. However, IBM does not 
guarantee service results or represent or warrant that all 
errors will be corrected. Any onsite programming services or 
assistance will be provided at a charge, 

WARRANTY 

EACH LICENSED PROGRAM IS DISTRIBUTED ON AN 'AS IS' BASIS 
WITHOUT WARRANTY OF ANY KIND EITHER EXPRESS OR IMPLIED. 

Requests for copies of IBM publications should be made to 
your IBM Representative or to the IBM Branch Office serving 
your locality. 

Address comments concerning the contents of this publication 
to IBM Corporation, Midwest Region Education Center, 1 IBM Plaza, 
20th Floor, Chicago, Illinois 60611. 

(g) Copyright International Business Machines Corporation 1972 
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Introduction 


This Program Description/Operations Manual provides Screen 
Designers, Systems Programmers and Assembler Language Applica¬ 
tions Programmers with the information they need to use the 
3270 FORMAT Macro for Output Data Streams in their Teleprocess¬ 
ing System. All readers should have a specific knowledge of the 
operation of the 3270 and in particular, the formatting of out¬ 
put Write and Write Erase data streams to the Local and Remote 
3270 Printer and Screen devices. An excellent educational 
offering that gives the student this knowledge is course G3687> 
3270 Operation and Design, taught at most IBM Education Centers. 

The Systems Programmer's main concern is with the require¬ 
ments necessary to include the FORMAT Macro support in his 
system. This information is found in the 'Installation Instruc¬ 
tions' section. 

The Screen Designer is responsible for laying out on a Screen 
Design Layout Form all of the necessary information for a Write 
or Write Erase output data stream. To assist the designer. 
Screen Design Layout Forms for both the 480 and 1920 size 3270 
screens are provided in Appendix A. The use of these forms is 
found in the section 'Operations Instructions - Using the 
Screen Design Layout Form'. 

The Application Programmer is responsible for writing the 
FORMAT Macro in his Assembler Language program by coding a 
series of FORMAT operands using the Screen Design Layout Form 
as a guide. The Macro Generator will check coding of the FORMAT 
Macro operands and will provide an output data stream acceptable 
for transmission to the 3270. The Screen Designer and Applica¬ 
tion Programmer work together in removing unacceptable or 
'abort' macro MNOTES created by the Macro Generator. Appendix 
E contains a list of MNOTES in numerical order. Information on 
coding the FORMAT Macro is contained in the section 'Operations 
Instructions - Coding the FORMAT Macro 1 . 

Appendix B and D contain sample FORMAT Macro Screen Layouts 
and expansions. Appendix C contains a quick summary of the 
FORMAT Macro Operands. 


System Overview 

The 3270 FORMAT Macro allows the Assembler Language Programmer 
to create write and write erase output data streams for the Local 
and Remote 3270 display screen and printer devices. Through a 
high level series of coded operands, the Programmer transfers a 
screen design layout form into Macro operands. The macro gen¬ 
erator checks the operands and creates a string of constants 
comprising an output data stream. 


In converting the operands to an output data stream, numerous 
checking and utility functions are performed such as computing, 
checking and translating Set Buffer Addresses from Row and Col¬ 
umn co-ordinates as well as computation, checking and transla¬ 
tion of Attribute Characters and Write Control Characters. The 
following functions/advantages are included in the FORMAT Macro: 

+ Convert high level operands coded in sequence from a screen 
design layout form into acceptable command and order se¬ 
quences. 

+ Allows the Programmer to specify absolute decimal addresses 
for Set Buffer Address, Repeat to Address, etc., sequences, 
or to use the easy to code Row and Column notation, with 
checking, conversion and translation provided for all 
addresses by FORMAT. 

+ Computes the Write Control Character utilizing high level 
character notation, combining multiple functions into a 
single Write Control Character with checking and translation 
provided by FORMAT. 

+ Checks for coded inconsistencies in the Write Control Char¬ 
acter. The following inconsistencies are checked: 

+ That Restore Keyboard is not specified for a printer 
device. 

+ That two printer commands such as honor NL and EM and 
honor 40 character line are not incorporated into the 
same Write Control Character. 

+ That Reset Modified Data Tags is not used with an 
Erase Write, warning. 

+ Computes, checks and translates the attribute character 
from a high level character string allowing default 
values for the attributes. The following inconsist¬ 
encies are checked: 

+ That Selector Pen Detect and Invisible are not both 
coded. 

+ That High Intensity and Invisible are not both coded. 

+ That Protected or Numeric are not coded when Autoskip 

is. 

+ Examines Selector Pen Detectable fields as specified by 
the Programmer for adherence to the following conven¬ 
tions : 
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+ A valid first character, i.e., null, blank, GT (greater 
than) or ? 

+ A minimum of one detectable character beyond the first 
character. 

+ Warning when appropriate on minimum size of the detec¬ 
table field. 

+ Warning when Programmer may be assuming an erase write 
and has not so specified. 

+ Warning when a field extends beyond the end of a Row 
and into the following Row. 

+• Warns the Programmer on inconsistent use of the Modified 
Data Tag in conjunction with Selector Pen Detect fields. 

+ Warns the Programmer when three nulls or blanks are not 
included at the end of the Selector Pen data field. 

+ Sequence checks the order of coded operands for inconsis¬ 
tencies in: 

+ Invalid Buffer Address specifications. 

+ Out of sequence Buffer Address specifications both ex¬ 
plicit and implicit. This capability may be supressed 
by the user. 

+ Checks for screen wrap operations that overlay previously 
coded fields regardless of starting location on screen. 
This capability may be supressed by the user. 

+ Cheeks for missing or incorrectly specified operands. 

+ Checks configuration specifications against coded 
operands, for example: 

Using STX, ESC or ETX sequences for a Local device, 

+ Using Erase Unprotected to Address or Programmed Tab 
together with Erase Write. 

+ Checks Repeat to Address, Erase Unprotected to Address, 

Programmed Tab, Insert Cursor and other character se¬ 
quences for: 

+ Missing, inconsistent or incorrectly specified informa¬ 
tion . 

+ Invalid Buffer Addresses. 
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+ Screen Wrap operations that overlap on previously coded 
fields. This capability may be supressed by the user. 

+ Provides the Programmer with flexibility in coding the Macro 
operands so that he may; 

+ Default to next buffer location addresses for Set Buffer 
Address Sequences (implicit specification), explicitly 
use Set Buffer Addresses sequences or eliminate Set 
Buffer Address sequences. 

+ Allow the use of field length decimal numbers in con¬ 
junction with specifying data fields or allow the Macro 
to compute field lengths from the supplied data, the 
former method providing for a more rigid control over 
Macro field checking. 

+ Incorporate Start of Text, End of Text, New Line and 
end of Medium characters in the data stream. 

+ Incorporate or eliminate Start Field orders in output 
data streams. 

+ Utilize the Insert Cursor Order anywhere in the output 
data stream. 

+ Allow the Macro Operands to be coded in any sequence or 
require the Programmer to code the operands in ascending 
sequence by buffer address. 

■+• Provides the Programmer with 6l numbered MNOTES to inform 
him of errors or warnings. 

+ MNOTES are numbered and pinpoint the operand and sub¬ 
operand number causing the MNOTE. 

+ MNOTES occur after code generation allowing the Program¬ 
mer to inspect the faulty generated code in most cases. 

+ Some mnotes issue warnings only and document possible 
problems, for example; 

+ Blanks or nulls missing at the end of a Selector Pen 
data field. 

+ Selector Pen fields extending from one Row into the 
next Row. 

+ Use of a New Line in output data streams to a screen 
device. 

+ Using a Programmed Tab or Erase Unprotected to Address 
operation following an erase write. 
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+ Other unnumbered MNOTES document useful information 

for the Programmer, for example: 

+ SBA sequence (start buffer address) addresses are 
MNOTed when not used at the beginning of a defini¬ 
tion or order to allow the Programmer to see where 
the current buffer address is by refering to his 
program listing. 

+ Beginning and ending addresses for a screen. 

+ Number of operands processed. 

+ Whether or not wrap occurred. 

+ The total size of the screen definition in core. 

The applications Programmer using the FORMAT Macro should 
first familiarize himself with the section entitled "Using 
the Screen Design Layout Form". The examples and illustra¬ 
tions in this Guide assume that a Screen Design Layout Form 
is the starting point for the Programmer's job and the con¬ 
ventions set up in the section, "Using the Screen Design Lay¬ 
out Form", should be understood by the Programmer before going 
on. 


Program Description 

FORMAT is an Assembler Macro which when included in an OS 
or DOS Assembler program or made available to any Assembler 
thru a Macro Library, allows the Programmer to create output 
data streams. Fourteen different types of high level operands 
coded in sequence for each output data stream are checked by 
the Macro Generator and result in a series of define constant 
statements together with documentary statements. The result¬ 
ing data stream can be written to a Local or Remote 3270 Dis¬ 
play Screen or Printer. 

In converting the operands to an output data stream, num¬ 
erous checking and utility functions are performed such as com¬ 
puting, checking and translating Set Buffer Addresses from Row 
and Column co-ordinates as well as computation, checking and 
translation of Attribute Characters and Write Control Charac¬ 
ters o 

FORMAT works with any level of DOS or OS Assembler and 
can be included with the Assembler program or made available 
to the Assembler thru a Macro Library. The data streams can 
be compiled separately or in the user's program. 


Installation Instructions 


FORMAT is distributed in 80 column cards with the first card 
a MACRO card and the last card a MEND card. It is thus ready 
for immediate use in any OS or DOS Assembler program merely by 
Including the macro at the start of the user's source cards. 
Optionally, FORMAT may be placed in the OS Macro Library or 
the DOS Source Statement Library by the Systems Programmer. 

The FORMAT-Macro consists of about 152 6 cards. Each card 
has a sequence number beginning with #1, the MACRO card. The 
sequence number is in columns 77-80. Comments are included 
in FORMAT to document its method of operation. These comments 
together with the Systems Guide for FORMAT allow the user to 
make modifications or understand its method of operation. 


OPERATIONS INSTRUCTIONS - USING THE SCREEN DESIGN LAYOUT FORM 

Any Screen Design Layout Form can be used with FORMAT such 
as those used in Appendix A or the IBM 3270 Layout Form, GX27- 
2951. 


Screen Name 


The screen name should be 1 to 8 characters, the first 
character must be alphabetic. In order to identify the in¬ 
formation returned and to assist the Programmer as well during 
error recovery operations, the screen designer might consider 
placing the screen name or a unique screen number on the screen 
at a pre-defined field location marked Protected, Invisible 
(non display/non print) with the Modified Data Tag set on. 

Each input data stream would then be uniquely identified. 
Placing this identification in the upper left hand field of 
the screen would allow early detection of the screen type in 
a scan of the input data stream where the Identification is 
also to be used as a transaction code by the Programmer. One 
must be careful to avoid a "Locked Buffer” if the Copy Com¬ 
mand is to be used. 


Write or Erase Write 

The designer should be aware that if he does not specify 
erase write, the buffer is not cleared to nulls and the Buffer 
Address and Cursor Locations are not set to 0. As a con¬ 
sequence, data character entry can begin, in the absence of a 
SBA sequence, at the buffer address containing the cursor or 
the current buffer address. The FORMAT Macro requires that 
the Programmer specify a SBA starting sequence when a write 
command is used instead of an erase write . For the most part, 
write commands will be used to send data to a previously for- 
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matted screen, i.e., one in which attribute characters have al¬ 
ready been stored in the buffer. For this reason, the FORMAT 
Macro will MNOTE Erase Unprotected to Address and Programmed 
Tab Orders when specified with an erase write. ~ 


Write Control Character for Printer or Screen Operation 

Certain items such as honor NL and EM codes, 40, 64 and 80 
character lines and other operations should be checked. Note 
that these items are mutually exclusive and will cause a Macro 
Abort if incorrectly specified. 


Defining Fields 


The Designer should now, as shown in Figure 1, enter the 
fields and attribute characters for fields that comprise his 
screen. Figure 1 assumes that an initial format is to be sent 
to the screen with an erase write command and that all fields 
will be preceded with attribute characters. For data involving 
a write operation, there would probably be few attribute charac¬ 
ters sent, if any, and the placing of data within an existing 
field would be more common. The placing of data within exist¬ 
ing fields can be done by a) SBA sequences followed by data, 
b) Erase Unprotected to Address sequences, c) Repeat to Address 
sequences followed or not by data and d) Programmed tab 
sequences followed or not by data. 


OPERATIONS INSTRUCTIONS - CODING THE FORMAT MACRO 

Each output data stream that you will code with the FORMAT 
Macro will consist of a single FORMAT statement appropriately 
labeled. Following the FORMAT statement will appear one or 
more operands . Each operand must be enclosed in parenthesis. 
Thus, the genera1 appearance of the macro statement will be: 

NAME FORMAT ( ), ( ), ( ), Etc. 

All operands must be separated by commas with no Intervening 
blanks . The NAME which is required may be any valid label in 
your program. It will be used in an EQU * statement to identify 
the beginning of your output data stream. 


Within each operand there may be suboperands . For example: 
SCREEN FORMAT (WCC,EW,RR), (PH, RlCl NAME *),(HN,42) f Etc. 

WCC, EW and RR are the 1st, second and third suboperands 
respectively of operand 1, (WCC,EW,RR). PH, RlCl and ’NAME* 
are the first, second and third suboperands of operand 2, etc. 
Note that a suboperand can be enclosed in quotes, 'NAME 1 , can 
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be a pure decimal number, 42, or can be letters and numbers 
mixed and not enclosed in quotes, PH, R1C1, etc. Regardless 
of how specified, each suboperand is still separated by commas 
and no Intervening blanks are allowed between suboperands . The 
number of commas plus one within any given operand equals the 
number of suboperands within an operand. Later, reference will 
be made to the effect that four suboperands are Implied . All 
this means is that there are three commas within the operand. 

You may have 100, 200 or 240 operands in any output data 
stream depending on the level of DOS or OS Assembler you are 
using. (See the section. System Capabilities and Limitations.) 
There are l4 different types of operands and the discussion 
that follows gives the rules for coding them. An operand may 
be split at any point on a source statement card in your pro¬ 
gram merely by coding a non blank character in column 72 and 
continuing the operand in column 16 of the next card. If you 
do not desire to split an operand, you may finish the operand 
on one card with, a right parenthesis, code a comma and a non 
blank character in column 72 and start the next operand in 
column 16 of the following card. In this way, one operand per 
card could be coded. The only rule to watch out for is that 
an operand may not exceed 127 or 255 characters depending on 
the level of DOS or OS Assembler you are using . This figure 
includes beginning and en3Tng~parenthesis, quotes and the com ¬ 
mas used to separate the operands . Later in this Guide, it 
will be shown how to overcome the limitation of 127 characters 
in a suboperand if this is encountered. A higher level version 
of the Assembler can also be used in which case each of the 
200 or 240 operands may be up to 255 characters in total length. 
(See the section. System Capabilities and Limitations.) 

The sequence in which you code the operands depends on your 
screen design layout. A certain few of the 14 operand types 
must come first (unless coded in a previous FORMAT Macro in 
which case they can be omitted), then the rest can be coded 
in any order so long as ascending order is maintained from 
order to order in a wrap fashion in your output data stream. 
Alternatively, you may code the CHECKING=NO operand as out¬ 
lined in Appendix I and can then code the operands in any se¬ 
quence. 

Within an operand, the sequence of suboperands is always 
very important. If you omit a suboperand you must never omit 
the commas that separate the suboperands. In the previous 
example, if you omitted the first suboperand of the second 
operand you must code (,R1C1,'NAME'). If you were to omit both 
the first and second suboperands you would code (,,'NAME 1 ). 

If, however, you do not use a third operand you merely code 
(PH,R1C1) or (,RlCl), i.e., you do not need a comma to indicate 
suboperands missing from the right hand end. 

With one of the operand types, you will find that if you 
omit the first suboperand you must not omit the 2nd or if you 
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omit the third suboperand you must not omit the 4th. Rules of 
this sort must be followed. 


If, within a suboperand that begins and ends in single quote 
marks, 1 , the data you desire to use is an apostrophe (single 
quote) or an ampersand, &, then you must code two apostrophes 
in a row or two ampersands in a row within the single quotes. 
For example, a suboperand consisting of ABC' would be coded 
as 1 ABC 1 ’ 1 . 


Format uses MNOTES to document three types of conditions, 
abort, warning and information useful to the programmer. In 
the later category are Included statistics on a) starting and 
ending buffer locations, b) number of operands processed. 


whether or not wrap occured, d) omitted SBA sequences and 


the number of bytes of core taken up by each output data 


stream. Warning MNOTES will appear in the diagnostic listing 
even with perfect assemblies. If this is disturbing, it is 
suggested that all output data streams be coded within a sep¬ 
arate CSECT together with ENTRY statements for each screen name, 
V type address constants or A type address constants with 
EXTRN's can then be used in other CSECTs that have need to 
refer to the output data stream. 


Configuration Operands (Local and Remote) 

The FORMAT Macro needs to know the buffer size, type of con¬ 
figuration and device type in order to adequately check other 
operands and warn you of errors or aboft the macro expansion 
if necessary. If the configuration operands are not coded as 
the first operands the FORMAT Macro will assume that the device 
is a Local Screen utilizing a 480 character buffer . The Macro 
assumes that the first three configuration operands are: 

NAME FORMAT (DEVICE= SGREEN ) ,(BUFFER=480) , (TYPE= LOCAL ) 

Since there are no commas, each of the three configuration 
operands contain a single suboperand. If you have a 480 char¬ 
acter local screen you could omit all three unless you wanted 
to document the use of the macro. On the other hand, if your 
output data stream were for a 1920 character remote printer, 
you would be required to code: 

NAME FORMAT (DEVICE-PRINTER),(BUFFER=1920),(TYPE=REMOTE) 

since in all three areas you differ from the default values of 
screen, 480 character buffer and local configuration. 

Once you have specified the three values and are coding 
pother FORMAT Macro, the three previous values will be In 
effect and you need not code them again in the same program 
unless one of the values changes. 
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In summary then, there are six configuration operands which 
may or may not have to be used. If they are used, they must 
always come as the first operands'? From dne to three configura¬ 
tion operands may be used for any one screen. Subsequent 
screens need not use the operands if all three items remain 
the same. 

Example: A Programmer starts an output data stream to a 480 
character screen at a remote location and does not 
desire to document the Macro. For his first FORMAT 
Macro usage, he codes: 

SCREEN FORMAT (TYPE=REMOTE), 

The default values for a 480 character buffer and a screen 
device are automatically in effect. For the next FORMAT Macro 
usage in the same program, he can omit (TYPE = REMOTE). Only if 
he changes one of the three items need he code a configuration 
operand again in a subsequent FORMAT Macro in the same program. 


Framing Operands (Remote Only), Optional 

If you are working with a remote device you may want to 
frame your output data stream by coding the (STX) operand and 
the (ETX) operand. 

To use the framing operands merely insert the (STX) follow¬ 
ing the configuration operands and put the (ETX) operand as 
the last operand in the Macro. 


Example: A Programmer knows that his output data stream will 
be sent as a single block transmission ending in 
ETX. He codes his macro as follows: 


SCREEN FORMAT ,(TYPE =RE MOTE) , (STX) , ( ),( ), , , (ETX) 


K-T 

1 or more 

Configuration 

Operands 


\ 


Framing 

Operand 




Y 


Other \Framing 
Operands Operand 


The configuration operand (TYPE=REMOTE) is required when 
using the (STX) or (ETX) operands. 


Write & Erase Write Command Operand (Remote) 

Following the configuration and framing operand (STX) if used, 
you should code the write or erase write command operand for the 
remote. The.format of this operand is as follows: "' 
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( ESC, 


EW, 1 or more suboperands separated by commas ) to 
W, represent bits to be set and translated by 
_J FORMAT in the Write Control Character. See 

Table of Suboperands for the Write Control Char¬ 
acter. 


Table of Suboperands for the Write Control Character 

One or more- suboperands may be coded beginning with the 
third suboperand of a write or erase write command operand 
for a remote or local device. 


Suboperand Codes Meaning 
MDT Reset Modified Data Tags 

RR Restore Keyboard 

SP Start Printer 

80 Print 80 Character Line 

64 Print 64 Character Line 

40 Print 40 Character Line 

NL Honor NL & EM Codes 

A Sound Audible Alarm 


Comment 

Should not be used with erase 
write. 

Should not be used when sent 
to printer. 


If used, avoid also using 
64, 40 and NL. 

If used, avoid also using 
80, 40 and NL. 

If used, avoid also using 
80, 64 and NL. 

If used, avoid also using 
80, 64 and 40. 


The first suboperand, ESC, must always be coded. The second 
suboperand must either be an E or EW. The third suboperand Is 
also required. 'The third and subsequent suboperands must be 
valid suboperand codes taken from the table of suboperands for 
the write control character. - The location of the write and 
erase write command operand should immediately follow the fram¬ 
ing operand, if used, in the following fashion: 

SCREEN FORMAT (TYPE=REMOTE),(STX),(ESC,EW,RR,A),( ),( ),,(ETX) 


L .J 

_ja 

L _ J 


Other 

IS 7 

1 or more 

Framing 

- 71 

Erase Writ 

e or \ 


Configuration Operand Write Command Operands 

Operands Optional Operand 

Required Required 


Although FORMAT will not Abort if the write or erase write 
command operand is omitted, FORMAT does make use of the"fact 
that an erase Is being done in its checking of subsequent 
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operands and will assume a write Is being done If no write or 
erase write command operand Is glvenT FORMAT will also check 
that two printer techniques have not both been coded, i.e., 
that only one suboperand from 80, 64, 40 and NL Is used. 

Example: A Programmer desires to issue a write command that 

restores the keyboard but does not reset modified 
data tags. He codes: 


SCREEN FORMAT (TYPE=REMOTE),(STX),(ESC,W,RR),( ), 

The generated 

code 

would be: 

1977+SCREEN 

EQU 

* 

1978+ 

DC 

X'02* STX 

1979 + 

DC 

X *27' ESC 

1980 + 

DC 

X'FI 1 WRITE 

1981 

1982 + 

DC 

*, WRITE CONTROL CHARACTER IS HEX 02 
AL1(194) ADDRESS, ATTRIBUTE OR WCC 


The Write Control Character will always be documented in a 
HEX value as shown in statement 1981. Following the statement 
will be listed the translated value for the WCC. The trans¬ 
lated value, statement 1982, will be in the form of a single 
byte address constant and will be labelled ADDRESS, ATTRIBUTE 
OR WCC. This is because the translation routine in FORMAT is 
common to translating addresses, attributes and write control 
characters. Backward reference to statement 1981 serves to 
pinpoint 1982 as a write control character in this example. 

Example: A Programmer desires to issue an erase write command 
to a remote printer that will start the printer and 
print an 80 character line. He codes: 

SCREEN FORMAT (TYPE=REMOTE),(DEVICE=PRINTER),(STX),(ESC,EW,SP,80), 


The generated code would be: 

EQU * 

DC X *02 1 STX 

nn y 107 s T?qp 

DC X , F5 I ERASE WRITE 

*,WRITE CONTROL CHARACTER IS HEX 38 
DC AL1(248) ADDRESS, ATTRIBUTE OR WCC 


Write and Erase Write Command Operand (local) 

Following the configuration operand, if used, you should 
code the write or erase write command operand for the local. 
The format of the operand is as follows: 


1977+SCREEN 

1978+ 

1979+ 

1980 + 

1981 

1982 + 
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( wcc. 


EW, 

W, 


1 or more suboperands separated by commas ) 
to represent bits to be set and translated 
by FORMAT in the Write Control Character. 

See Table of Suboperands for the Write Control 
Character in the section entitled "Write & 
Erase Write Command Operand (remote)". 


The first suboperand. WCC, must always be coded. The sec¬ 
ond suboperand must be either an El or an The third sub- 

operand is required. The third suboperand and subsequent sub- 
operands must be valid suboperand codes taken from the Table 
of Suboperands for the Write Control Character. The location 
of the write and erase write command operand should immediately 
follow the configuration operands, if used, in the following 
fashion: 


SCREEN 


FORMAT (BUFFER=1920),,(WCC,EW,RR,A), ( 




1 


-?K- 


1 or more /Erase Write or 
Configuration Write Command 
Operands Operand 

Required 


), 


Other 

Operands 


Although FORMAT will not terminate if the write or erase 
write command operand is omitted, IfOrMt does make use of 
the fact that an erase is being done In its checking of~~sub- 
sequent operands and will assume a write is being done If no 
write or erase'write command operand is given. FORMAT will 
also check' that two printer techniques have not both been 
coded, i.e., that only one suboperand from 80 , 64, 40 and NL 
is used. 


Example: A Programmer desires to issue a write command that 

restores the keyboard but does not reset modified 
data tags. He codes: 

SCREEN FORMAT (WCC,W,RR), (•), 

The generated code would be: 

1980+SCREEN EQU * 

1981 *,WRITE CONTROL CHARACTER IS HEX 02 

1982 + DC AL1(194) ADDRESS, ATTRIBUTE OR WCC 

The Write Control Character will always be documented in a 
HEX value as shown in statement 1981. Following the statement 
will be listed the translated value for the WCC. The trans¬ 
lated value, statement 1982 , will also be in the form of a 
single byte address constant and will be labeled ADDRESS, 
ATTRIBUTE OR WCC. This is because the translation routine in 
FORMAT is common to translating addresses, attributes and 
write control characters. Backward reference to statement 1981 
serves to pinpoint 1982 as a write control character. 
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Example: A Programmer desires to issue an erase write command 

to a local printer that will start the printer and . 
print an 80 character line. He codes: 

SCREEN FORMAT (DEVICE^PRINTER),(WCC,EW,SP,80),( ), 

The generated code would be: 

1980 +SCREEN EQU * ' 

1981 *,WRITE CONTROL CHARACTER IS HEX 38 

1982+ DC AL1(248) ADDRESS, ATTRIBUTE OR WCC 


Basic Operand (Local & Remote) 

The basic operand is the most flexible and most often used 
operand in any output data stream. With the basic operand, 
the Programmer can: 


Set up a start field sequence with or without a preceding 
Set Buffer Address order and with or without data follow¬ 
ing the start field order. 


- Write data into the output data stream (without a preceding 
start field order) with or without a preceding Set Buffer 
Address order. 

The flexibility is also indicated by the numerous entries in 
Appendix C, FORMAT Macro Instruction Format Summary, under 
the Basic Operand. The format of the operand is as follows: 


Suboperand #1, 
Attribute 
Character 
Suboperand 


Suboperand #2, 
Set Buffer 
Address 
Suboperand 


Suboperand #3 
Data 

Suboperand 


( X, 

Omitted, 

Attribute Sequence, 
(See Table of 
Attribute Characters) 

Suboperand #4, 

Field Length 
Suboperand 


Row & Column Sequence, 
Decimal Number 0-1919* 
X, . 

Omitted, 


Data in Single 

Quotes, 

Omitted, 


Length of Field ) 

in Decimal Number , 

Not Used 

In coding a basic operand, you must always code two or more 
suboperands, i.e., a minimum of one comma is mandatory. If 
you'omit the second~suboperand and only decide to use the~Tirst 
suboperand, you must still code the second suboperand as an X. 
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Prior to examining each of the suboperands, it is well to kdep 
in mind the most common usage of the basic operand. 

Required: Set up a SBA order at Row 3, Column 15 and place an 
attribute character for high intensity, protected 
data in that location. Fill the field with the 
data, 'NAME'. Translate the attribute character 
and convert and translate the SBA order address. 

Solution: Code the basic operand as (PH,R3C15>'NAME 1 ) 


The first suboperand sets up a protected, high intensity 
attribute character following the SBA sequence specified by 
the second operand. Data, ‘NAME 1 , follows in the output data 
stream. The sequence in which one codes the basic operands 
and intermixes them with RA, fcepeat to Address operands, B'uA, 
Erase Unprotected to Address operands and FT7 Programmed Tab 
operands must be in ascending~order beginning with a buffer 
address or defaulting to the~~first location in r "the buffer~and 
con'tinuing in a wrap fashion'up" to but not beyond the starting 
point. If you do not desire to code the FORMAT Operands in ” 
ascending sequence, you should code the CHECKING*NO operand 
as outlined in Appendix I. For example, I may choose to start 
my output data stream at the 4th row, column 1 of a 480 charac¬ 
ter buffer, code successively higher and higher basic, RA and 
EUA opeaands and wrap to the first row of the screen, ending 
with a basic operand defining a field on the third row. The 
FORMAT macro has its own internal current buffer address which 
is incremented just as the hardware CBA is incremented when 
data is written into the buffer. FORMAT keeps track of where 
you start your coding and if you wrap and come back and begin 
to exceed your starting address. Macro abort occurs with an 
appropriate mnote message. In order to use FORMAT then, you 
must code operands in ascending sequence from your starting 
operand location. You may wrap but must not exceed this start¬ 
ing address. The only exception is the Insert Cursor operand 
which can be coded to be placed in sequence or out of sequence 
if desired. If you specify CHECKING-NO as outlined in Appendix 
I, you can code all of the operands in any sequence. 

At the end of a successful expansion, FORMAT prints out the 
starting 3270 buffer address and ending 3270 buffer address. 
Note that this Is quite different from the number of core posi¬ 
tions used as the later includes control characters, addresses, 
orders, etc. FORMAT will also print out the total number of 
operands processed and whether or not wrap, as defined above, 
occurred. If you are using a write command instead of an erase 
write, FORMAT will require that you begin your output data 
stream with an SBA sequence whether you start the output data 
stream with a basic operand, RA, EUA or insert cursor operand. 
This means that if you start with a basic operand after your 
write command operand, a valid buffer address entry in the sec- 
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ond suboperand of the basic operand is required. The same 
holds true if you were to start with a RA, EUA or IC Operand. 

The first suboperand is used to set up an attribute charac¬ 
ter and will generate a start field order followed by a checked 
and translated attribute character. If the suboperand is coded 
X, no start field order will be generated. If omitted, a de¬ 
fault attribute character defined as unprotected, alphameric, 
normal intensity, non selector pen detectable with the modified 
data tag turned off will be generated. These are all of the 
default values for the attribute character. The user may alter 
the default values by setting up his own attribute character 
by using an attribute sequence and refering to the table of 
attribute characters below. 


Table of Attribute Characters 


Value Code 


Attribute 


Comment 


P 

N 

A 

S 


Protected 

Numeric 

Autoskip 

Selector Pen 
Detectable 


Not to be used with a 
value code A. 

Not to be used with value 
code A. 

A-P+N, neither P nor N 
should be used. 

Not to be used with I. 


H 

M 

I 


High Intensity 
Modified Data Tag 
Invisible 


Not to be used with I. 


Not to be used with S or H. 


For example, (AS, RICl) defines an attribute character as a 
selector pen detectable, autoskipped field. If the first 
character of the field is a greater than or ? then it 

will truly be selector pen detectable. The default values of 
normal intensity and no modified data tag are also in effect. 
(HMN,R3C4) defines an unprotected numeric field of high in¬ 
tensity with the modified data tag set on. If the first char¬ 
acter of data in the field is a yi, )f> s greater than or question 
mark then it will also be selector pen detectable as well. 

This is because of the way in which the attribute character is 
calculated. The high intensity bit will also make the field 
selector pen detectable. It is the presence of one of 4 
designator characters (?, greater than, null or blank) that 
makes the field truly detectable. (,R1C1) defines a default 
attribute: unprotected, alphameric, normal intensity, non 
selector pen detectable with the modified data tag turned off. 
The code generated for the start field order is: 
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For a first suboperand coded N (numeric): 

2180+ DC X*1D* SF 

2181 *,ATTRIBUTE CHARACTER IS HEX 10 

2182+ DC ALl(80) ADDRESS, ATTRIBUTE OR WCC 


For a first suboperand coded NS (numeric, detectable): 

1910+ DC X'lD' SF 

1911 *,ATTRIBUTE CHARACTER IS HEX 14 

1912+ DC AL1(212) ADDRESS, ATTRIBUTE OR WCC 

As with the write control character, the calculated bit 
configuration of the untranslated attribute character is given 
in hexidecimal form. The translated value is also given in 
both its decimal and hexidecimal equivalent at the left hand 
side of the listing. The table of attribute characters lists 
various invalid combinations that cause Macro Abort conditions. 
Note that Autoskip, A, implies P and N and that P and A, N and 
A, and P and N, are invalid. 

The second suboperand, (RICl), defines an SBA sequence which 
will precede the start field sequence. If the start field se¬ 
quence has been omitted then the SBA sequence only will be gen¬ 
erated, for example (X, R1C3). The SBA sequence can be omitted 
by coding an X or by a ,, (comma, comma) sequence. Whenever 
coding the basic operand, at least two suboperands must be used. 
A start field sequence with no preceding SBA sequence would 
be coded (lP,X) and would generate only a start field order 
followed by an attribute character defining an invisible, pro¬ 
tected, alphanumeric field. If you use three or more sub¬ 
operands you may use either X or ,, to omit the second sub¬ 
operand. You cannot code (IP,,) because the third suboperand 
or data operand, if implied, as it is in this case due to the 
presence of two commas, must never be omitted unless a valid 
4th suboperand is coded which it isn’t. Both (IP,,’DATA') and 
(IP,X,'DATA 1 ) would achieve the effect of omitting the SBA 
suboperand when three suboperands are used. 

In coding the second suboperand, you may use Row and Column 
notation or decimal notation. 480 character buffers have 12 
lines (rows) with 4o positions per line (columns). Valid 
specifications are rows 1 to 12 and columns 1-40.Any other rows 
or columns are invalid. 1920 character buffers have 24 lines 
(rows) with 80 positions per line (columns). Valid specifica¬ 
tions are rows 1-24 and columns 1-80. Alternately, a decimal 
number of 0 thru 479 or 0 thru 1919 may be specified. The 
vertical column on the lefthand side of the Screen Design Lay¬ 
out Form is designed to assist one in using decimal numbers. 

All digits must be numeric and the decimal number must be within 
the correct buffer size range as specified in the buffer con¬ 
figuration operand or defaulted to, i.e., 480. A basic operand 
coded (SH,R7C3V?bTYPEbM') generates: 
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1440+ 

DC 

X'll' SBA 


l44l 


*,SBA BUFFER ADDRESS IS 274 DECIMAL 


1442+ 

DC 

AL1(196) ADDRESS, ATTRIBUTE OR WCC 

V. J? 

1443+ 

DC 

AL1(210) ADDRESS, ATTRIBUTE OR WCC 


1444+ 

DC 

X’lD' SF 


1445 

1446+ 

DC 

*,ATTRIBUTE CHARACTER IS HEX 08 

AL1(200) ADDRESS, ATTRIBUTE OR WCC 


1447+ 

DC 

CL9 1 ?-bTYPEbbb * i 



f 

The SBA address order precedes the start field order. Two 
address bytes follow the SBA order. (The HEX representations 
of the A type Addresses appear at the left hand margin.) 

If the Programmer had coded (SH,274, * ?^TYPE34 j^ 1 ), the re¬ 
sults would have been Identical. If the current buffer address 
is set at the desired location by a previous operand, the SBA 
sequence is not required. For example, the prior operand may 
specify a repeat to address to location 274 or an erase un¬ 
protected to address to location 274 or insert data into 
location ,273. ,/Che Programmer could code (SH,, , ?bTYPEooo , ) or 
(SH,X, , ?bTYPEbbb r ) and the following would result: 


l44o 


*,MNOTE 55, SBA SEQUENCE AT 274, OMITTED 

l44l + 

DC 

X*1D* SF 

1442 


*,ATTRIBUTE CHARACTER IS HEX 08 

1443 + 

DC 

AL1(200) ADDRESS, ATTRIBUTE OR WCC 

1444 + 

DC 

CL9 * ?#TYPE-t5tfb * 


MNOTE 55 is generated to document the omitted SBA sequence. 

When data is read back from this field, it will be necessary 
to know the address plus one of the attribute character. If 
the Programmer had been working with Row and Column notation or 
had omitted the SBA sequence, he could use FORMAT MNOTE 55 in 
the later case, as input to routines that examine input data 
streams for incoming SBA sequences. With Row and Column nota¬ 
tion, he merely has to examine his listing to locate the proper 
decimal value in the two byte address constant. One Assembly 
documents the address which can be utilized in the next Assembly 
of the program. 

The Programmer can code (,,'DATA 1 ) in which case he will 
generate: 

1440 *,MNOTE 55, SBA SEQUENCE AT 274, OMITTED 

1441+ DC X'lD' SF 

1442+- *, ATTRIBUTE CHARACTER IS HEX 00 

l443 f DC ALl(64) ADDRESS, ATTRIBUTE OR WCC 

1444+ DC CL4'DATA» 

This results in an omitted SBA sequence and a default 
attribute character value. The same result can be achieved 
by coding (^'DATA')- 

i 
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Also possible at this point would be (X,,'DATA‘) or 
(X,X,'DATA*) in which case FORMAT would generate: 

1440 *,MNOTE 55, SBA SEQUENCE AT 274, OMITTED 

l44l+ DC CL4'DATA' 

Now, both the SBA and start field orders have been omitted. 

At this point, read APPENDIX F, MNOTES for SBA Sequences - 
Discussion. 


The third suboperand of the basic operand is used to place 
data in the write output data stream. The data is enclosed in 
single quotation marks. The single quote marks are mandatory. 

If data within single quotes is omitted in the third suboperand 
and a fourth suboperand is implied then the 4th suboperand must 
be present and must contain a valid decimal number. (SH,R1C1,,) 
is illegal, so is (SH,R1C1,). If the attribute code specifies 
selector pen detectable then the third suboperand must be 
present. 


The data in quotes is placed into the output data stream. 

The length of the data within the quote marks will always be 
used to define the character constant. If the data is so long 
that the entire operand exceeds 127 or 255 characters including 
parenthesis, quotes and commas, then the data can be truncated 
and split into two pieces. Assume that you must split the 
first 10 characters of the alphabet and place the entire 10 
characters starting at location 2. You would code: (X,2,'ABODE 1 ), 
(X,,'FGHIJ’). 

The generated code would be: 


l44o + 

DC 

1441 


1442 + 

DC 

1443 + 

DC 

1444 + 

DC 

1445 


1446 + 

DC 


X'll 1 SBA 

*,SBA BUFFER ADDRESS IS 2 DECIMAL 
ALl(64) ADDRESS, ATTRIBUTE OR WCC 
AL1(194) ADDRESS, ATTRIBUTE OR WCC 
AL5‘ABODE' 

*,MNOTE 55,.SBA SEQUENCE AT 7, OMITTED 
CL5'FGHIJ 1 


Although only ten characters were split, the method may be 
applied any number of times to larger character strings. 

If you have specified selector pen detect in the attribute 
character then you must code a third operand in single quotes 
and the data within the quotes must conform to the following 
conventions: 


If the first character of the data is not a ?, > , null or 
blank you will abort with Mnote 26. 

If the last three positions of the field do not contain 
three blanks or nulls, you will be warned with Mnote 56 . 
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If the selector pen data field extends from one row into the 
next, you will be warned with Mnote 51• 

If> has been specified as the first data character and no 
modified data tag has been set, you will be warned with Mnote 
52. 


- If a null, blank or ? has been specified in the first data 
character together with the modified data tag in the attribute 
character, you will be warned with Mnote 53. 

- If the length of the data between the quotes is only one 
character, you will abort with Mnote 27. 

- If the data between quotes is not at least five characters 
you will be warned with Mnote 28. (This assumes a desig¬ 
nator character, a single displayable character and three 
nulls or blanks will be the most common form of minimum 
data.) 

The fourth suboperand is optional except when the third sub¬ 
operand is omitted and a 4th suboperand has been implied by use 
of three commas. It is used to tell FORMAT the total length of 
the field when the third suboperand has data in it which is 
less than the total field length. For example, assume that 
only the first five characters of a field are to be placed into 
the field, the rest to contain nulls. For more precise check¬ 
ing by FORMAT you may code (PH,R3C4,'NAMES 1 ,10). You could just 
as easily have coded (PH,R3C4,‘NAMES ! ). In the first case, 

FORMAT will increase the buffer location by 10 whereas in the 
later case, FORMAT will increase the buffer location by 5. 

Suppose now that you make a mistake and code (l,R3C12, 1 JOHN*) 
as the next operand. FORMAT will catch this error in the first 
case but not in the second. The next operand should be 
(I,R3C15,* JOHN 1 ) . 

When you use the 4th operand to tell FORMAT that the data of 
the third operand does not fill up the entire field, the 4th 
operand must contain all decimal numbers. For a selector pen 
detectable field with the 4th operand specified, FORMAT will 
assume that the remaining positions of the field are to be set 
to nulls and will warn you with Mnote 29 if you have not 
specified an erase write. 

Format will also protect you in one other way in conjunction 
with using the 4th operand. Consider the following sequence: 


1433 T90 

FORMAT 

(WCC,EW,RR),(X,,‘DATA *),(,,*2ilO), 
(N,,*3 { ) 7 

1434+T90 

1435 

EQU 

* 

*,WRITE CONTROL CHARACTER IS HEX 02 

1436+ 

1437 

DC 

AL1(194) ADDRESS, ATTRIBUTE OR WCC 
*,MNOTE 55, SBA SEQUENCE AT 0, OMITTED 

1438+ 

DC 

CL4‘DATA‘ 
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1439 

1440+ 

DC 

*,MN0TE 55, SBA SEQUENCE AT 4, OMITTED 
X'1D‘ SF 

1441 
1442+ 

DC 

*,ATTRIBUTE CHARACTER IS HEX 00 

AL1(64) ADDRESS, ATTRIBUTE OR WCC 

1443 + 

DC 

CL1'2' 

1444 + 

DC 

X'll 1 SBA 

1443 

1446 + 

DC 

*,SBA BUFFER ADDRESS IS 15 DECIMAL 
AL1(64) ADDRESS, ATTRIBUTE OR WCC 

1447 + 

DC 

AL1(79) ADDRESS, ATTRIBUTE OR WCC 

1448 + 

DC 

X * ID 1 SF 

1449 

1450 + 

DC 

*,ATTRIBUTE CHARACTER IS HEX 10 

ALl(80) ADDRESS, ATTRIBUTE OR WCC 

1451 + 

DC 

CL1'3' 

1452 

1453 

1454 


*,STARTING ADDRESS 4, ENDING ADDRESS l6 
*,4 OPERANDS PROCESSED 

*,TOTAL CORE FOR FORMAT T90 WAS 14 BYTES 


Because an erase write was specified, FORMAT will allow 
omission of the SBA sequence in the 2nd operand. The default 
attribute character and omission of the third operand is also 
OK. Note, however, that the Programmer wishes to omit the SBA 
order for the 4th operand. If FORMAT allowed this, the start 
field order would come immediately after the CL1'2' statement. 
Under these circumstances, FORMAT will not allow omission of 
the SBA order sequence for the 4th operand and supplies it of 
its own accord as it has done following the CLl’2'. He cannot 
omit the SBA order sequence for the 4th operand by coding an X. 

Finally, it must be said that (,,,10) and (X,,,10) are 
allowed where no data is to be written into a field with or 
without an attribute character, but the field length checking 
capability is desired. At this point it is well to review 
APPENDIX G - MNOTES in conjunction with Illegal Wrap Opera¬ 
tions - Discussion. 


Erase Unprotected to Address Operand (Local & Remote) 


The Erase Unprotected to Address Operand is used to place an 
EUA order in the output data stream with or without a preceding 
SBA order sequence. It can also be used to erase all unprotected 
data in an entire buffer. The format of the operand is as fol¬ 
lows: 


Suboperand #1, 
Identifier 


( EUA, 


Suboperand #2 
Set Buffer 
Address 
Suboperand 


Row & Column Sequence, 

Decimal Number 0-1919, 
X, 

Omitted, 


Suboperand #3, 

Erase Unprotected 
to Address 
Address Suboperand 

Row & Column Se¬ 
quence, 

Decimal Number 0-1919 
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In coding an EUA operand you must always code three sub¬ 
operands. The second suboperand only can be omitted, i.e., 
the first and third suboperands are required. The purpose 
of the EUA operand is to set up an EUA order in the output 
data stream and the operand must be coded in its correct 
ascending screen location sequence intermixed with basic 
operands, RA, Repeat to Address operands and other operands 
in an increasing fashion allowing wrap, as described in 
APPENDIX G and in the discussion of the basic operand, (if 
CHECKING=NO is specified as per Appendix I, this later re¬ 
quirement is not necessary.) To illustrate its usage assume 
the following: 

Required: Set the buffer address to Row 1, Column three and 
erase all unprotected data from that location up 
to but not including location 285. 

Solution: Code the EUA operand as (EUA,R1C3,285) 

The first suboperand identifies the operand as an EUA 
operand. The second operand sets up the SBA sequence prior 
to the EUA order and the third operand sets up the EUA 
address as required by the order. The generated code would 
look like: 

2056+ DC 

2057 

2058+ DC 

2059+ DC 

2060+ DC 

2061 

2062+ DC 

2063+ DC 


X'll* SBA 

*,SBA BUFFER ADDRESS IS 2 DECIMAL 
AL1(64) ADDRESS, ATTRIBUTE OR WCC 
AL1(194) ADDRESS, ATTRIBUTE OR WCC 
X 1 12 1 EUA 

*,EUA BUFFER ADDRESS IS 285 DECIMAL 
AL1(196) ADDRESS, ATTRIBUTE OR WCC 
AL1(93) ADDRESS, ATTRIBUTE OR WCC 


The second suboperand defines an SBA order which, if not 
omitted thru the use of ,, or X, will precede the EUA order. 

If omitted as in the following example, MNOTE 55# will be given 
to pinpoint the value of the omitted SBA sequence. If you 
coded (N,R1C2,’DATA*), (EUA,,R2C2), the generated code would 
be: 


2929 + 

DC' 

2930 


2931 + 

DC 

2932 + 

DC 

2933 + 

DC 

2934 


2935 + 

DC 

2936 + 

DC 

2937 


2938 + 

DC 

2939 


2940 + 

DC 

2941 + 

DC 


X'll' SBA 

*,SBA BUFFER ADDRESS IS 1 DECIMAL 
ali(64) address, attribute OR WCC 
ALl(l93) address, attribute OR WCC 

X 1 ID * SF 

*,ATTRIBUTE CHARACTER IS HEX 10 
ali(8o) address, attribute OR WCC 

CL4'DATA' 

*,MNOTE 55, SBA SEQUENCE AT 6, OMITTED 
X 1 12 1 EUA 

*,EUA BUFFER ADDRESS IS 4l DECIMAL 
ALl(64) address, attribute OR WCC 
AL1(233) ADDRESS, ATTRIBUTE OR WCC 
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The third suboperand which cannot be omitted is used to set 
up the EUA buffer address and can be specified as a decimal 
number or with row and column notation. The discussions of 
APPENDIX F and APPENDIX G apply to both the second and third 
suboperands of an EUA operand. 

If an EUA is specified in an erase write output data stream, 
a warning is issued. If the programmer desires to erase all 
unprotected data by coding an EUA address equal to the current 
buffer location, FORMAT will not consider this a wrap. Any 
way of bringing the current buffer address to equal the EUA 
address is legitimate. 


Repeat to Address Operand (Local & Remote) 

The repeat to address operand is used to place a RA order 
into the output data stream, with or without a preceding SBA 
sequence, together with the repeat to address character and 
optionally, followed by additional data. It may also be used 
to propagate a single character into all locations of an en¬ 
tire buffer. The format of the operand is as follows: 


Suboperand #1, Suboperand #2, 
Identifier Set Buffer 

Address 

Suboperand 


Suboperand #3* 
Repeat to Address 
Address 
Suboperand 


RA, 

Row & Column Sequence, 


Row & Column Sequence, 


Decimal Number 0-1919* 


Decimal Number 0-1919* 


X, 


_ 


Omitted, 



Suboperand #4, Suboperand #5 

Repeat to Address Data 
Character Suboperand 


Single Data 
Character in 
Single Quotes, 
Single Data 
Character without 
Quotes, 


Data in Single 
Quotes, 

Slot Used 


Suboperand #6 
Field Length 
Suboperand 

Length of Field in ) 
Decimal Number, 

Not Used 


In coding a RA operand you must always code four or more sub¬ 
operands. If you code less than four suboperands, FORMAT will 
abort the Macro expansion with Mnote 30. The second suboperand 
can be omitted but the 1st, 3rd and 4th are required. The pur¬ 
pose of the RA operand is to set up a RA order in the output 
data stream and the operand must be coded in its correct ascend¬ 
ing screen location sequence intermixed with basic operands, 

EUA operands and other operands as described in the discussion 
on using the basic operand. (if CHECKING=N0 is specified as 
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per Appendix I, this later requirement is not necessary.) To 
illustrate the usage of the RA operand assume that the follow¬ 
ing is required. 


Required: A large autoskip field on the first 80 character 

row of a Model 2 screen is to contain the first 
10 letters of the alphabet, 54 asterisks, the 
next 10 letters of the alphabet and 6 nulls, all 
in high intensity. 

Solution: (AH,R24 c 80, ' ABCDEFGHIJ*) ,(RA, ,R1C&5,*, 'KLMNOPQRST*, l6) 

The first operand sets an attribute character in the last 
position in the buffer and writes 10 characters in the first 
ten locations of row 1. The expansion of the RA operand would 
be: 


2139 


2140+ 

DC 

2l4l 


2142+ 

DC 

2143+ 

DC 

2144 + 

DC 

2145 + 

DC 


*,MN0TE 55, SBA SEQUENCE AT 10, OMITTED 
X»3C* RA 

*,RA BUFFER ADDRESS IS 64 DECIMAL 
AL1(64) ADDRESS, ATTRIBUTE OR WCC 
AL1(127) ADDRESS, ATTRIBUTE OR WCC 
CL1'* 1 

CLIO*KLMNOPQRST* 


The second suboperand in the RA operand defines an SBA se¬ 
quence which if not omitted through the usage of ,, or X, will 
precede the RA sequence. If the output data stream in the 
example was not positioned as it was with the first operand 
that wrote data into row 1, columns 1 thru 10, then the RA 
operand could have been coded (RA,RICH,R1C65,*, 'KLMNOPQRST*, l6) . 
If omitted, as in the example, MNOTE 55 will pinpoint the 
omitted value. 

The third suboperand which cannot be omitted, is used to set 
up the RA buffer address and can be specified as a decimal num¬ 
ber or using row and column notation. The discussions in 
APPENDIX F and G apply to both,the second and third suboperands 
of a RA operand. 

The fourth suboperand cannot be omitted and it specifies 
the single character to be propagated into all buffer locations 
up to but not including the third suboperand buffer address 
value. It must be in quotes if it is a blank or a comma. If 
a character of the alphabet, a number or a special character, 
you may omit the framing quotes. 

Suboperand #5, which is optional, allows you to follow the 
single propagated data character with data. The data. If 
specified, must be in single quotes. This data will be writ¬ 
ten into the buffer starting in the address specified by sub¬ 
operand #3 which is the 'Stop* address for the Repeat to 
Address Order. You may specify suboperand #5 by itself or you 
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may specify both suboperand #5 and #6. You may not omit sub¬ 
operand #5 and code suboperand #6 by itself. Coding suboperand 
#6, if used, tells FORMAT that the data field that follows the 
Repeat to Address sequence, extends beyond the data specified 
in suboperand #5. The decimal value specified in suboperand #6 
includes the data length in suboperand #5 plus any remaining 
nulls to finish out the length of the field. In the example, 
there are 16 positions ending the first row but only the first 10 
of these have data written into them. Suboperand #6 is used 
for more precise checking purposes as with suboperand #4 in the 
basic operand. 

FORMAT will not abort the Macro generation if a Repeat to 
Address order for a length greater than 480 characters is 
specified and is followed by more data in the output data stream. 
Such a condition may cause overrun at the 3270 and should be 
avoided. 


Insert Cursor Operand (Local & Remote) 


The insert cursor operand is used to place an insert cursor 
order into the output data stream, with or without a preceding 
SBA sequence. By coding the insert cursor operand with an X 
in the 3rd suboperand, FORMAT will allow you to place the IC 
operand anywhere in the sequence of operands. FORMAT will not 
alter the value of its own CBA when the third suboperand is 
specified with an X. Coding of the insert cursor operand under 
all circumstances does not cause FORMAT to increase the CBA. 

The format for the insert cursor operand is: 


Suboperand #1, 
Identifier 


Suboperand #2, 
Set Buffer 
Address 
Suboperand 


Suboperand #3, 
Out of Sequence 
Specification 
Suboperand 


IC, 

Row & Column Sequence, 


X, 


Decimal Number 0-1919, 


Not Used 


Not Used 


L_ 


If you desire to insert the cursor order as the very next con¬ 
stant in the output data stream, without any need to set the 
buffer address, you need only code (IC) . If you wish to pre¬ 
cede the IC order with an SBA order sequence you should code 
(IC,R1C3) or (lC,285). You must put the operand in its proper 
ascending sequence of operands if you use the two later methods. 
(If CHECKING^NO is specified as per Appendix I, this later re¬ 
quirement is not necessary.) If you do not desire to code the 
IC operand in its sequential ascending operand order you should 
code (IC, 285,X) or (lC,RlC3,X). FORMAT will now omit all 
checking for sequence. This will occur even though CHECKING= 
YES was coded or defaulted to as outlined in Appendix I. If 
you use an X in the third operand, you must specify a second 
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operand. After coding the IC operand with an X in the third 
operand you must pick up where you left off in the ascending 
sequence of operands. For example, (IC,55) will generate: 


1750+ 

DC 

1751 


1752+ 

DC 

1753+ 

DC 

1754 + 

DC 


X r ll* SBA 

*, SBA BUFFER ADDRESS IS 55 DECIMAL 
AL1(64) ADDRESS, ATTRIBUTE OR WCC 
AL1(247) ADDRESS, ATTRIBUTE OR WCC 
X»13' IC 


To illustrate coding the IC operand with an X in the third sub¬ 
operand location, consider the following sequence of operands: 
(AH,R8C5,'DATA2»),(IC,R7C3,X),(N,R8C15,'X') 


The generated code will be: 


2492 + 

DC 

X‘11 J SBA 


2493 


*,SBA BUFFER ADDRESS IS 564 

DECIMAL 

2494 + 

DC 

AL1(200) ADDRESS, ATTRIBUTE 

OR WCC 

2495 + 

DC 

AL1(244) ADDRESS, ATTRIBUTE 

OR WCC 

2496 + 

DC 

X 1 ID ! SF 


2497 


*,ATTRIBUTE CHARACTER IS HEX 38 

2498+ 

DC 

ALl(248) ADDRESS, ATTRIBUTE 

OR WCC 

2499 + 

DC 

CL5'DATA2 * 


2500 + 

DC 

X'll' SBA 


2501 


*,SBA BUFFER ADDRESS IS 482 

DECIMAL 

2502 + 

DC 

AL1(199) ADDRESS, ATTRIBUTE 

OR WCC 

2503 + 

DC 

ALI( 226 ) ADDRESS, ATTRIBUTE 

OR WCC 

2504 + 

DC 

x‘13' IC 


2505 + 

DC 

X’ll’ SBA 


2506 


*,SBA BUFFER ADDRESS is 574 

DECIMAL 

2507 + 

DC 

AL1(200) ADDRESS, ATTRIBUTE 

OR WCC 

2508 + 

DC 

AL1(126) ADDRESS, ATTRIBUTE 

OR WCC 

2509 + 

DC 

X 1 ID’ SF 


2510 


*,ATTRIBUTE CHARACTER IS HEX 10 

2511 + 

DC 

ALl(80) ADDRESS, ATTRIBUTE OR WCC 

2512 + 

DC 

CL1 5 X 1 



The third operand (N,R8C15>*X 1 ) picks up where the first operand 
left off and no problems arise due to the second operand being 
out of sequence with respect to the first and third operands. 


Programmed Tab Operand (Local & Remote) 

A PT operand is used to put the PT order in the output data 
stream followed by data or by itself. The format for the PT 
operand is as follows: (PT) or 

Suboperand #1, Suboperand #2, 

Identifier Expected Tab 

Address 
Suboperand 
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Suboperand #3 
Data Suboperand 



( PT, 


X, 

Row & Column Sequence, 

Decimal Number 0-1919> 

The second suboperand if not omitted by coding an X is used 
internally by FORMAT. It contains the expected address of the 
first character of the data in quotes in the 3rd suboperand. 

That is to say, it is the address of the first character loca¬ 
tion in the next highest sequential unprotected field that will 
be found in a forward scan. The expansion for a PT operand 
(PT,R5C8,•DATAbTObTABBED'), follows. 

1434+ DC X'05* 

1435+ DC CL17' 

The second suboperand if used must be in ascending sequence 
of addresses and can therefore cause any of the messages as 
described in APPENDIX G. (if CHECKING=NO is specified as per 
Appendix I, this later requirement is not necessary.) FORMAT 
will not warn the Programmer when the PT operation causes true 
wrap from the bottom row to the top row. The only warnings 
will be as discussed in APPENDIX G. If the Programmer merely 
desires to clear the end of a field to nulls and not follow 
the PT order with data, he should code (PT). Note that two (PT)'s 
in a row may require an intervening null. 

New Line and End of Medium Operands (Local & Remote) 

By coding a (NL) or (EM) operand, the Programmer may format 
output to a printer (must be used for a dedicated Model 3 
printer). 


PT 

DATA^TO^TABBED * 


X, 

Data in Single ) 
Quotes 


System Capabilities & Limitations 


100 to 240 operands with 127 or 255 characters per operand 
for each use of the Macro depending on whether a high level of 
the Assembler is used or not as per the following table: 


Assembler 


Maximum 
Number of 
Operands 


Maximum Number 
of Characters 
Per Operand 


DOS Assembler D 
DOS Assembler F 
OS Assembler F 
OS Assembler H* 

*IBM Product Program 


100 

127 

200 

255 

200 

255 

24 0 

255 


Information in Appendix A thru E - Discussion 

Appendix A contains the Screen Design Layout Forms for the 
480 and 1920 character buffer devices. 
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Appendix B contains sample Screen Design Layout forms, in par¬ 
ticular, Figures 1 & 2, discussed in the section "Using the 
Screen Design Layout Form". In addition, a test screen. Figure 
3, is given to illustrate the way in which FORMAT will Mnote 
errors. All three screens. Figures 1 thru 3 , have been coded 
and submitted to FORMAT and the resultant macro expansions are 
listed in Appendix D. 

Appendix C contains a listing of all of the FORMAT Macro 
Instruction Operands in all of the various possible combina¬ 
tions in the form of a Macro Instruction Summary. It can be 
used as a quick cross check as to possible methods of coding 
each of the 14 different types of FORMAT operands. 

Appendix D contains FORMAT Macro Instruction listings for the 
three screens of Figures 1, 2 and 3 shown in Appendix B. The 
discussion of Figures 1 and 2 is contained in the section "Uging 
the Screen Design Layout Form". Coding of the FORMAT Macro 
Operands is discussed in the section "Coding the FORMAT Macro". 

Appendix E contains a listing of all of the MNOTES referred to 
in the section "Coding the FORMAT Macro". The MNOTES are num¬ 
bered and appear in numerical order for easy reference. Where 
information is supplied by the FORMAT Macro at the time the 
MNOTE is produced in the output listing. Appendix E substitutes 

three underlines, _, to indicate that the value will be put 

into the MNOTE by FORMAT. 
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Screen Name 


SCREEN DESIGN LAYOUT FORM - 480 CHARACTER SCREEN 


- - Columns 


2 3 14 5 6 7 8 9 10 11 


R2 40 


R3 80 




iiiiniiiminii 


R4 120 


R5 160 
R6 200 
R7 240 


imnin 

inniin 


vo R9 320 


RIO 3SO 

Rll 400 


R12 440 




- 


Check Appropriate Box 
A WRITE A ERASE WRITE 
A LOCAL A REMOTE 

Write Control Character for Printer Operation 
A START PRINTER 
A HONOR NL & EM CODES Start Coding Output 

A 40 CHARACTER LINE Stream at Location - 

A 64 CHARACTER LINE _ 

A 80 CHARACTER LINE 

A RESET MODIFIED DATA TAG Insert Cursor at 

Location - 


Write Control Character for Screen Operations 
A RESET MODIFIED DATA TAGS 
A RESTORE KEYBOARD AND RESET AID 
A SOUND AUDIBLE ALARM 
Color Code for Attribute Character 
P - PROTECTED - BROWN 
N - NUMERIC - BLUE 
H - HIGH INTENSITY - RED 
I - INVISIBLE - YELLOW 
S - SELECTOR PEN DETECT - ORANGE 
M - MODIFIED DATA TAG - GREEN 
A - AUTOSKIP - PINK (P+N) 


APPENDIX A, SCREEN DESIGN LAYOUT FORM - 480 CHARACTER SCREEN 






Screen Name 


SCREEN DESIGN LAYOUT FORM - 1920 CHARACTER SCREEN 


- - - Columns - - - 
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Check Appropriate Box 
A WRITE A ERASE WRITE 
A LOCAL A REMOTE 
Write Control Character for 
A START PRINTER 
A HONOR NL & EM CODES 
A 40 CHARACTER LINE 
A 64 CHARACTER LINE 
A 80 CHARACTER LINE 
A RESET MODIFIED DATA TAG 


Printer Operation 


Write Control Character for Screen Operations 
A RESET MODIFIED DATA TAGS 
A RESTORE KEYBOARD AND RESET AID 
A SOUND AUDIBLE ALARM 
Color Code for Attribute Character 


Start Coding Output 
Stream at Location - 


Insert Cursor 
Location - 


at 


P 

N 

H 

I 

S 

M 

A 


PROTECTED - BROWN 

NUMERIC - BLUE 

HIGH INTENSITY - RED 

INVISIBLE - YELLOW 

SELECTOR PEN DETECT - ORANGE 

MODIFIED DATA TAG - GREEN 

AUTOSKIP - PINK (P+N) 


APPENDIX A, SCREEN DESIGN LAYOUT FORM - 1920 CHARACTER SCREEN 









Screen Name Rfr/337 


SCREEN DESIGN LAYOUT FORM - 480 CHARACTER SCREEN 


- -- Columns - - - 



Write Control Character for Printer Operation 
A START PRINTER 

A HONOR NL & EM CODES Start Coding Output 

A 40 CHARACTER LINE Stream at Location - 

A 64 CHARACTER LINE RiCj _._ 

A 80 CHARACTER LINE 

A RESET MODIFIED DATA TAG Insert Cursor at 

Location - /?/2Ci9_ 


A' SOUND AUDIBLE ALARM 
Color Code for Attribute Character 
P - PROTECTED - BROWN 
N - NUMERIC - BLUE 
H - HIGH INTENSITY - RED 
I - INVISIBLE - YELLOW 
S - SELECTOR PEN DETECT - ORANGE 
M - MODIFIED DATA TAG - GREEN 
A - AUTOSKIP - PINK (P+N) 


APPENDIX B - Figure 






Screen Name 


BPPSPi 


SCREEN DESIGN LAYOUT FORM - 480 CHARACTER SCREEN 


Columns - - - 
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Check Appropriate Box 
A' WRITE A ERASE WRITE 
A - LOCAL A REMOTE 

Write Control Character for Printer Operation 
A START PRINTER 

A HONOR NL & EM CODES Start Coding Output 

A 40 CHARACTER LINE Stream at Location - 

A 64 CHARACTER LINE ft7Ci _ 

A 80 CHARACTER LINE 

A RESET MODIFIED DATA TAG Insert Cursor at 

Location - PiCi 


Write Control Character for Screen Operations 
A RESET MODIFIED DATA TAGS 
A RESTORE KEYBOARD AND RESET AID 
A SOUND AUDIBLE ALARM 
Color Code for Attribute Character 
P - PROTECTED - BROWN 
N - NUMERIC - BLUE 
H - HIGH INTENSITY - RED 
I - INVISIBLE - YELLOW 
S - SELECTOR PEN DETECT - ORANGE 
M - MODIFIED DATA TAG - GREEN 
A - AUTOSKIP - PINK (P+N) 


APPENDIX B - Figure 





























Screen Name 
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SCREEN DESIGN LAYOUT FORM - 480 CHARACTER SCREEN 
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Check Appropriate Box 
A WRITE ERASE WRITE 
A LOCAL A" REMOTE 

Write Control Character for Printer Operation 
A START PRINTER 

A HONOR NL & EM CODES Start Coding Output 

A 40 CHARACTER LINE Stream at Location - 

A 64 CHARACTER LINE _ R1C3Q _ 

A 80 CHARACTER LINE 

A RESET MODIFIED DATA TAG Insert Cursor at 

Location - R7Clo 


Write Control Character for Screen Operations 
A RESET MODIFIED DATA TAGS 
A RESTORE KEYBOARD AND RESET AID 
A SOUND AUDIBLE ALARM 
Color Code for Attribute Character 
P - PROTECTED - BROWN 
N - NUMERIC - BLUE 
H - HIGH INTENSITY - RED 
I - INVISIBLE - YELLOW 
S - SELECTOR PEN DETECT - ORANGE 
M - MODIFIED DATA TAG - GREEN 
A - AUTOSKIP - PINK (P+N) 
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APPENDIX B - Figure 






































APPENDIX C J FORMAT MACRO INSTRUCTION FORMAT SUMMARY 




Configuration Operands 

(DEVICE=SCREEN) (type=local) (buffer-48o) 

(device-Printer) (type-remote) (buffer = 1920 ) 

Framing Operands (Remote Only) 

(STX) (ETX) 


Write and Erase Write Command Operand (Remote) 

(ESC,EW, see table for codes) (ESC,W,see table for codes) 


Suboperand Codes Meaning 

Comment 

MDT 

Reset Modified Data Tags 

Should not be used with 
erase write. 

RR 

Restore Keyboard 

Should not be used when 
sent to printer. 

SP 

Start Printer 


80 

Print 80 Character Line 

If used, avoid also 
using 64, 60 and NL. 

64 

Print 64 Character Line 

If used, avoid also 
using 80, 40 and NL. 

40 

Print 40 Character Line 

If used, avoid also 
using 80, 64 and NL. 

NL 

Honor NL & EM Codes 

If used, avoid also 
using 80 , 64 and 40. 

A 

Sound Audible Alarm 


Write and Erase Write Command Operand (Local) 

(WCC,EW,see table for codes) (WCC,W, see table for codes) 


Basic Operand (Local & Remote) 


Table of Attribute Characters 




Value Code 

Attribute 


Comment 


P 

Protected 

Not to 

be used with a value code A. 


N 

Numeric 

Not to 

be used with value code A. 

i: 

A 

Autoskip 

A=P+N, 

used. 

neither J? nor N should be 
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S Selector Pen Not to be used with I. 

Detectable 

H High Intensity Not to be used with I. 

M Modified Data Tag 

I Invisible Not to be used with S or H. 


(see table,X) Start Field Order and Attribute from Table 
(,X) Default value of Start Field/Attribute 

(see table,address,data) SBA, Start Field Order and Attribute 

from Table, Data 

(see table,address,data,field length) Same as above only with 

Field Length 

(,address,data) SBA,Default value of Start Field/Attribute, 

Data 

(,address,data,field length) Same as above only with Field 

Length 

(see table,,data) Omit SBA, Start Field Order and Attribute 

from Table, Data 

i see table,X,data) Same as above. 

,,data) Omit SBA, Default value of Start Field/Attribute data 
X,,data) Omit SBA, Omit Start Field Order, Data 
X,X,data) Same as above. 

X,address,data) SBA, Omit Start Field, Data 

X,address,data,field length) Same as above only with Field 

length 

(see table,,data,field length) Omit SBA, Start Field Order and 

Attribute from Table,Data with 
Field Length. 

(see table,,,field length) Omit SBA, Start Field Order and 

Attribute from Table, Omit Data, 
Field Length. 

(,,data,field length) Omit SBA, Default value of Start Field/ 

Attribute, Data with Field Length 
(,,,field length) Omit SBA, Default value of Start Field/ 

Attribute, Omit Data, Field Length 
(,X,,field length) Same as above. 

(X,,, field length) Omit SBA, Omit Start Field, Omit Data, 

Field Length (rarely used) 

(X,X,data,field length) Omit SBA, Omit Start Field, Data 

with Field Length 

(X,,data,field length) Same as above. 


Erase Unprotected to Address Operand (Local & Remote) 

(EUA, SBA address,EUA address) SBA, EUA Order, EUA Address 
(EUA,,EUA address) Omit SBA, EUA Order, EUA Address 
(EUA,X,EUA address) Same as above. 
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Repeat to Address Operand (Local & Remote) 

(RA,SBA address,RA address,RA character) SBA, RA Order, RA 

Address, RA Character 
(RA,,RA address, RA character) Omit SBA, RA Order, RA Address, 

RA Character 

(RA,X,RA address,RA character) Same as above. 

(RA,SBA address,RA address,RA character,data) SBA, RA Order, 

RA Address, RA 
Character, Data 

(RA,,RA address,RA character,data) Omit SBA, RA Order, RA 

Address, RA Character* Data 
(RA,X,RA address,RA character,data) Same as above. 

(RA,SBA address,RA address,RA character,data,field length) 

SBA, RA Order, RA Address, RA Character, Data with Field 
Length 

(RA,,RA address,RA character,data,field length) Same as above. 


Insert Cursor Operand (Local & Remote) 

(IC) IC Order 

(IC, SBA address) SBA, IC Order 

(IC,SBA address,X) SBA, IC Order (Does not have to appear in 

sequence.) 


Programmed Tab Operand (Local & Remote) 
(PT) PT Order 

(PT,PT address,data) PT Order, Data 
(PT,X,data) PT Order, Data 
(PT,PT address,X) PT Order 


New Line & End of Medium Operands (Local & Remote) 

(NL) New Line Order 
(EM) End of Medium Order 


Checking Operand (Local & Remote) 

(CHECKING =YES) 

(CHECKING=M5J 
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APPENDIX D - SAMPLE FORMAT MACRO INSTRUCTION EXPANSIONS 

1491 SCRN387 FORMAT (TYPE-REMOTE) , (STX) , (ESC,EW,RR, A) , (MPI,R1C1, 'SCRN387 ') ,X 

(P,R2C6,'ENTER NAME '),(H,X),(IC),(P,R3Cl4,'ID 
(HP,R4C40),(RA,,R6C1,'-'),(P,R7C4,'SELECT CLASS'),(?S,r8X 

C6,'? CSDA ' ),(PS,R8C20,'? BTAM WORKSHOP '),(PS,R9C6X 
,'? CSDP '),(PS,R9C20,«? QTAM WORKSHOP '),(PS,R10C6,X 
»? 3270 0 D '),(PS,R10C20,'? TCAM WORKSHOP '),(ETX) 


0091 


1492+SCRN387 

EQU 

* 

0091 

02 

1493+ 

DC 

X '02' STX 

0092 

27 

1494 + 

DC 

X'27’ ESC 

0093 

F5 

1495 + 

DC 

X'F5' ERASE WRITE 



1496 


*,WRITE CONTROL CHARACTER IS HEX 06 

0094 

C6 

1497 + 

DC 

AL1(198) ADDRESS, ATTRIBUTE OR WCC 

0095 

11 

1498 + 

DC 

X'll’ SBA 

0096 


1499 


*,SBA BUFFER ADDRESS IS 0 DECIMAL 

40 

■1500 + 

DC 

AL1(64) ADDRESS, ATTRIBUTE OR WCC 

0097 

40 

1501 + 

DC 

AL1(64) ADDRESS, ATTRIBUTE OR WCC 

X' ID' SF 

0098 

ID 

1502+ 

DC 



1503 


*,ATTRIBUTE CHARACTER IS HEX 2D 

0099 

6d 

1504 + 

DC 

AL1(109) ADDRESS, ATTRIBUTE OR WCC 

CL7'SCRN387' 

009A E2C3D9D5F3F8F7 

1505 + 

DC 

OOA1 

11 

1506 + 

DC 

X'll' SBA 



1507 


*,SBA BUFFER ADDRESS IS 45 DECIMAL 

00A2 

40 

1508+ 

DC 

ALl(64) ADDRESS, ATTRIBUTE OR WCC 

OOA3 

6D 

1509+ 

DC 

ALl(109) ADDRESS, ATTRIBUTE OR WCC 

OOA4 

ID 

1510 + 

DC 

X * ID' SF 



1511 


*,ATTRIBUTE CHARACTER IS HEX 20 

OOA5 

60 

1512 + 

DC 

AL1(96) ADDRESS, ATTRIBUTE OR WCC 

CLI1'ENTER NAME ' 

OOA6 

C5D5E3C5D940D5C1 

1513 + 

DC 



1514 


*,MNOTE 55> SBA SEQUENCE AT 57, OMITTED 

OOB1 

ID 

1515 + 

DC 

X'lD* SF 



1516 


*,ATTRIBUTE CHARACTER IS HEX 08 

00B2 

C8 

1517 + 

DC 

ALl(200) ADDRESS, ATTRIBUTE OR WCC 

OOB3 

13 

1518 + 

DC 

X’13' IC 

OOB4 

11 

1519 + 

DC 

X'll' SBA 



1520 


*,SBA BUFFER ADDRESS IS 93 DECIMAL 



00B5 Cl 

1521 + 

DC 

00B6 5D 

1522 + 

DC 

00B7 ID 

1523 + 

1524 

DC 

00B8 60 

1525 + 

DC 

00B9 C9C47A 

1526 + 

1527 

DC 

OOBC ID 

1528 + 

1529 

DC 

OOBD C8 

1530 + 

DC 

OOBE 11 

1531 + 

1532 

DC 

OOBF C2 

1533 + 

DC 

OOCO 5F 

1534 + 

DC 

00C1 ID 

1535 + 

1536 

DC 

00C2 e8 

1537 + 

1538 

DC 

00C3 3C 

1539 + 
•1540 

DC 

00C4 C3 

1541 + 

DC 

OOC5 C8 

1542 + 

DC 

00C6 60 

1543 + 

DC 

00C7 11 

1544 + 

1545 

DC 

OOC8 C3 

1546 + 

DC 

OOC9 F3 

1547 + 

DC 

OOCA ID 

1548 + 

1549 

DC 

OOCB 60 

1550 + 

DC 

OOCC E2C5D3C5C3E340C3 

1551 + 

DC 

00D8 11 

1552 + 

1553 

DC 

00D9 C4 

1554 + 

DC 

OODA 5D 

1555 + 

DC 

OODB ID 

1556 + 

1557 

DC 

OODC E4 

1558 + 

DC 

OODD 6F40C 3E2C4C14040 

1559 + 

DC 

00E6 11 

1560 + 

1561 

DC 

00E7 C4 

1562 + 

DC 


AL1(193) address, attribute or wcc 
ali( 93 ) address, attribute or wcc 

X'lD' SF 

*,ATTRIBUTE CHARACTER IS HEX 20 
AL1(96) ADDRESS, ATTRIBUTE OR WCC 
CL3'ID ' 

*,MNOTE 55, SBA SEQUENCE AT 97, OMITTED 
X'lD' SF 

*,ATTRIBUTE CHARACTER IS HEX 08 
AL1 (200) ADDRESS, ATTRIBUTE OR- WCC 
X‘11' SBA 

*,SBA BUFFER ADDRESS IS 159 DECIMAL 
AL1 (19*0 ADDRESS, ATTRIBUTE OR WCC 
AL1(95) ADDRESS, ATTRIBUTE OR WCC 
X’lD* SF 

*,ATTRIBUTE CHARACTER IS HEX 28 
AL1(232) ADDRESS, ATTRIBUTE OR WCC 
*,MNOTE 55, SBA SEQUENCE AT 160, OMITTED 
X’3C 1 RA 

*,RA BUFFER ADDRESS IS 200 DECIMAL 
AL1(195) ADDRESS, ATTRIBUTE OR WCC 
AL1(200) ADDRESS, ATTRIBUTE OR WCC 
CL1 1 - 1 
X'll' SBA 

*,SBA BUFFER ADDRESS IS 243 DECIMAL 
AL1(195) ADDRESS, ATTRIBUTE OR WCC 
AL1(243) ADDRESS, ATTRIBUTE OR WCC 
X'lD' SF 

*,ATTRIBUTE CHARACTER IS HEX 20 
AL1(96) ADDRESS, ATTRIBUTE OR WCC 
CL12'SELECT CLASS' 

X'll' SBA 

*,SBA BUFFER ADDRESS IS 285 DECIMAL 
AL1(196) ADDRESS, ATTRIBUTE OR WCC 
AL1(93) ADDRESS, ATTRIBUTE OR WCC 
X'lD' SF 

*,ATTRIBUTE CHARACTER IS HEX 24 
AL1(228) ADDRESS, ATTRIBUTE OR WCC 
CL9'? CSDA ' 

X'll' SBA 

*,SBA BUFFER ADDRESS IS 299 DECIMAL 
AL1(196) address, attribute or wcc 



00E8 

6B 

1563+ 

DC 

00E9 

ID 

1564+ 

1565 

DC 

OOEA 

E4 

1566+ 

DC 

OOEB 

6F40C2E3C1D440E6 

1567+ 

DC 

OOFD 

11 

1568+ 

1569 

DC 

OOFE 

C5 

1570+ 

DC 

OOFF 

C5 

1571 + 

DC 

0100 

ID 

1572+ 

1573 

DC 

0101 

e4 

1574 + 

DC 

0102 

6F40C3E2C4D74040 

1575 + 

DC 

010B 

11 

1576 + 

1577 

DC 

010C 

C5 

1578+ 

DC 

010D 

D3 

1579+ 

DC 

010E 

ID 

1580 + 

1581 

DC 

010F 

E4 

1582+ 

DC 

0110 

6F40D8E3C1D440E6 

•1583 + 

DC 

0122 

11 

1584 + 

1585 

DC 

0123 

C5 

1586 + 

DC 

0124 

6D 

1587 + 

DC 

0125 

ID 

1588 + 

1589 

DC 

0126 

E4 

1590 + 

DC 

0127 

6 F4OF3F2F7F040D6 

1591 + 

DC 

0134 

11 

1592 + 

1593 

DC 

0135 

C5 

1594 + 

DC 

0136 

7B 

1595 + 

DC 

0137 

ID 

1596 + 

1597 

DC 

0138 

E4 

1598 + 

DC 

0139 

6F40E3C3C1D440E6 

1599 + 

DC 

Ol4B 

03 

1600 + 

1601 

1602 

1603 

DC 


AL1(107) ADDRESS, ATTRIBUTE OR WCC 
X 1 ID' SF 

*,ATTRIBUTE CHARACTER IS HEX 24 
ALl(228) ADDRESS, ATTRIBUTE OR WCC 
CLl8'? btam WORKSHOP ' 

X'll' SBA 

*,SBA BUFFER ADDRESS IS 325 DECIMAL 
AL1(197) address, attribute OR WCC 

ALl(l97) address, attribute OR WCC 

X'lD' SF 

*,ATTRIBUTE CHARACTER IS HEX 24 
AL1(228) ADDRESS, ATTRIBUTE OR WCC 
CL9'? CSDP 1 
X'll' SBA 

*,SBA BUFFER ADDRESS IS 339 DECIMAL 
AL1(197) ADDRESS, ATTRIBUTE OR WCC 

AL1(211) ADDRESS, ATTRIBUTE OR WCC 

X'lD' SF 

*,ATTRIBUTE CHARACTER IS HEX 24 
AL1(228) ADDRESS, ATTRIBUTE OR WCC 
CL18'? QTAM WORKSHOP ' 

X'll' SBA 

*,SBA BUFFER ADDRESS IS 365 DECIMAL 
AL1(197) ADDRESS, ATTRIBUTE OR WCC 
AL1(109) ADDRESS, ATTRIBUTE OR WCC 
X'lD' SF 

*,ATTRIBUTE CHARACTER IS HEX 24 
AL1(228) ADDRESS, ATTRIBUTE OR WCC 
CL13'? 327O 0 D ' 

X'll' SBA 

*,SBA BUFFER ADDRESS IS 379 DECIMAL 
ALI(197) ADDRESS, ATTRIBUTE OR WCC 
AL1(123) ADDRESS, ATTRIBUTE OR WCC 
X'lD' SF 

*,ATTRIBUTE CHARACTER IS HEX 24 
AL1(228) ADDRESS, ATTRIBUTE OR WCC 
CL18'? TCAM WORKSHOP ' 

X'03' ETX 

*,STARTING ADDRESS 0, ENDING ADDRESS 397 
*,19 OPERANDS PROCESSED 

*,TOTAL CORE FOR FORMAT SCRN387 WAS 187 BYTES 



1604 BPPS21 FORMAT (TYPE=LOCAL),(WCC,W,MDT,RR,A),(MPI,R7C1,'BPPS21*), X 

(PH,,'BOOK/PAGE/PARAGRAPH/SENTENCE CORRECTION FORX 
M NUMBER TWENTY ONE'),(P,R9C1,'BOOK®'),(,,'SERIES21- 1 ,X 
15),(P,,'PAGE®'),(,,'NO.',10),(P,,'PARAGRAPH='),(,,'PARAX 
NO.*12),(P,,'SENTENCE®'),(,,* '),(PT,R12C29,'92136X 
875'),(EUA,R1C1,R3C19),(IC,R1C1,X) 


i 

o 

I 


Ol4C 

1605+BPPS21 

l606 

EQU 

Ol4C C7 

1607 + 

DC 

014D 11 

1608+ 

1609 

DC 

Ol4E C 3 

1610+ 

DC 

014F FO 

1611+ 

DC 

0150 ID 

1612+ 

1613 

DC 

0151 6D 

l6l4+ 

DC 

0152 C2D7D7E2F2F1 

1615+ 

.1616 

DC 

OI58 ID 

1617+ 

DC 

1618 

1619+ 

DC 

0159 E8 

1620-t- 

DC 

015A C2D6D6D261D7C1C7 

4* 


01A1 11 

1621+ 

1622 

DC 

01A2 C5 

1623+ 

DC 

01A3 40 

1624+ 

DC 

01A4 ID 

1625+ 

1626 

DC 

01A5 60 

1627+ 

DC 

01A6 C2D6D6D27E 

1628+ 

1629 

DC 

01AB ID 

1630+ 

1631 

DC 

01AC 40 

1632+ 

DC 

01AD E2C5D9C9C5E2F2F1 

1633+ 

DC 

01B6 11 

1634+ 

1635 

DC 


* 

*,WRITE CONTROL CHARACTER IS HEX 07 
AL1(199) ADDRESS, ATTRIBUTE OR WCC 
X'll' SBA 

*,SBA BUFFER ADDRESS IS 240 DECIMAL 
AL1(195) ADDRESS, ATTRIBUTE OR WCC 
AL1(240) ADDRESS, ATTRIBUTE OR WCC 
X'ID' SF 

*,ATTRIBUTE CHARACTER IS HEX 2D 
AL1(109) ADDRESS, ATTRIBUTE OR WCC 
CL6'BPPS21' 

*,MNOTE 55, SBA SEQUENCE AT 247, OMITTED 
X * ID' SF 

*,ATTRIBUTE CHARACTER IS HEX 28 
ALl(232) ADDRESS, ATTRIBUTE OR WCC 

CL71'BOOK/PAGE/PARAGRAPH/SENTENCE CORRECTION FORMX 
NUMBER TWENTY ONE 1 
X'll' SBA 

*,SBA BUFFER ADDRESS IS 320 DECIMAL 
AL1(197) ADDRESS, ATTRIBUTE OR WCC 
AL1(64) ADDRESS, ATTRIBUTE OR WCC 
X'ID' SF 

*,ATTRIBUTE CHARACTER IS HEX 20 
ALI(96) ADDRESS, ATTRIBUTE OR WCC 
CL5'B00K=' 

*,MNOTE 55, SBA SEQUENCE AT 326, OMITTED 
X * ID' SF 

*,ATTRIBUTE CHARACTER IS HEX 00 
AL1(64) ADDRESS, ATTRIBUTE OR WCC 
CL9'SERIES21-' 

X'll' SBA 

*,SBA BUFFER ADDRESS IS 342 DECIMAL 




01B7 C5 

1636 + 

DC 

01B8 d 6 

1637 + 

DC 

01B9 ID 

1638 + 

1639 

DC 

01BA 60 

1640 + 

DC 

01BB D7C1C7C57E 

1641 + 

1642 

DC 

01C0 ID 

1643 + 

1644 

DC 

01C1 40 

1645 + 

DC 

01C2 D5D64B 

1646 + 

DC 

01C5 11 

1647 + 

1648 

DC 

oic6 C5 

1649 + 

DC 

01C7 E7 

1650 + 

DC 

01C8 ID 

1651 + 

1652 

DC 

01C9 60 

1653 + 

DC 

01CA D7CID9C1C7D9C1D7 

1654 + 

1655 

DC 

01D4 ID 

•1656 + 

1657 

DC 

01D5 40 

1658 + 

DC 

oid6 D7C1D9C1D5D64B 

1659+ 

DC 

01DD 11 

1660 + 

1661 

DC 

01DE C5 

1662+ 

DC 

01DF 7F 

1663+ 

DC 

01E0 ID 

1664 + 

1665 

DC 

01E1 60 

1666 + 

DC 

01E2 E2C5D5E3C5D5C3C5 

1667 + 

1668 

DC 

01EB ID 

1669+ 

1670 

DC 

01EC 40 

1671 + 

DC 

01ED 404040404040 

1672 + 

DC 

01F3 05 

1673 + 

DC 

01F4 F9F2F1F3F6F8F7F5 

1674 + 

DC 

01FC 11 

1675 + 

1676 

DC 


AL1(197) ADDRESS, ATTRIBUTE OR WCC 
ALl(2l4) ADDRESS, ATTRIBUTE OR WCC 
X 1 ID 1 SF 

*,ATTRIBUTE CHARACTER IS HEX 20 
AL1(96) ADDRESS, ATTRIBUTE OR WCC 
CL5'PAGE~' 

*,MNOTE 55, SBA SEQUENCE AT 348, OMITTED 
X' ID' SF 

*,ATTRIBUTE CHARACTER IS HEX 00 
AL1(64) ADDRESS, ATTRIBUTE OR WCC 
CL3'NO.' 

X'll' SBA 

*,SBA BUFFER ADDRESS IS 359 DECIMAL 
AL1(197) ADDRESS, ATTRIBUTE OR WCC 
AL1(231) ADDRESS, ATTRIBUTE OR WCC 
X' ID' SF 

*,ATTRIBUTE CHARACTER IS HEX 20 
AL1(96) ADDRESS, ATTRIBUTE OR WCC 
CLIO'PARAGRAPH-' 

*,MNOTE 55, SBA SEQUENCE AT 370, OMITTED 
X * ID * S P 

*,ATTRIBUTE CHARACTER IS HEX 00 
ALl(64) ADDRESS, ATTRIBUTE OR WCC 
CL7'PARAN0.' 

X'll' SBA 

*,SBA BUFFER ADDRESS IS 383 DECIMAL 
ALl(197) ADDRESS, ATTRIBUTE OR WCC 
AL1(127) ADDRESS, ATTRIBUTE OR WCC 
X'ID' SF 

*,ATTRIBUTE CHARACTER IS HEX 20 
AL1(96) ADDRESS, ATTRIBUTE OR WCC 
CL9'SENTENCE=' 

*,MNOTi: 55, SBA SEQUENCE AT 393, OMITTED 
X'ID' SF 

*,ATTRIBUTE CHARACTER IS HEX 00 
AL1(64) ADDRESS, ATTRIBUTE OR WCC 
CL6' ' 

X'05' PT 
CL8'92136875' 

X'll' SBA 

*,SBA BUFFER ADDRESS IS 0 DECIMAL 



OlFD 

40 

1677+ 

DC 

OlFE 

40 

1678+ 

DC 

OlFF 

12 

1679+ 

1680 

DC 

0200 

Cl 

1681+ 

DC 

0201 

E2 

1682+ 

DC 

0202 

11 

1683+ 

1684 

DC 

0203 

40 

1685+ 

DC 

0204 

4o 

1686+ 

DC 

0205 

13 

1687+ 

1688 

1689 

1690 

1691 

DC 


ALl(64) address, attribute or wcc 
AL1(64) address, attribute or wcc 

X' 12 1 EUA 

*,EUA BUFFER ADDRESS IS 98 DECIMAL 
AL1{193) ADDRESS, ATTRIBUTE OR WCC 
AL1(226) ADDRESS, ATTRIBUTE OR WCC 
X'll* SBA 

*,SBA BUFFER ADDRESS IS 0 DECIMAL 
ALl(64) ADDRESS, ATTRIBUTE OR WCC 
AL1(64) ADDRESS, ATTRIBUTE OR WCC 
X f 13 f xc 

*,STARTING ADDRESS 240, ENDING ADDRESS 97 

*,WRAP OCCURRED 

*,15 OPERANDS PROCESSED 

*,TOTAL CORE FOR FORMAT BPPS21 WAS 186 BYTES 



To illustrate a badly coded screen, consider TEST1, in 
Figure 3 of APPENDIX B. An erase write causes mnote 59, 57 
and 6l. The selector pen detect field causes mnotes 56 and 
51. Note that the mnotes pinpoint both the operand and sub-‘ 
operand in the case of mnotes 59 and 56 . 

The Programmed Tab operation assumes that a previously 
defined unprotected field attribute character has been de¬ 
fined at R5C7.. The erase write mnote #57, Statement #1450, 
alerts the programmer that this command will have wiped out 
the assumed attribute character. 

Mnote 6l at Statement 1453 warns the Programmer of the pos¬ 
sible error in using an erase unprotected to address sequence 
when an erase write has been specified. Mnote 59 at Statement 
1420 is the first programmer warning that he has incorrectly 
specified an EW when he really wants W in operand #3. By 
referring to mnotes 59* 57 and 6l, the Programmer should con¬ 
clude that a write is what he had in mind. 

Statements 1467 and 1472 illustrate the omission of two 
SBA sequences and the documentation by mnote 55* The final 
address referred to in Statement 1488 can be calculated by 
adding the 23 bytes of Statement 1483 to the SBA address at 
Statement 1477, i.e., 274 + 23 * 297. 

The total core of 143 bytes can be checked by subtracting 
the STX address, 002 HEX from the ETX address, 090 HEX, and 
adding 1, i.e., (090-002) +1 = 08D + 1 = 08E HEX - 143 Decimal. 
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1415 TEST1 

FORMAT (TYPE=REMOTE),(SIX),(ESC,EW,RR,MDT),(PH,R1C38,'DATA *), X 
(,R2C6,'DATA WHICH IS QUITE LONG IS INTERESTING'),(RA,10X 
0,R4C32,X,'REST',10),(PT,R5C8,'DATA TO BE TABBED'),(EUA,X 
,R6C8),(IC,R7C10),(,,'DOUBLE DEFAULT'),(N,),(SH,R7C35, 1 X 
THIS IS NEXT LINE TEST'),(ETX) 

0002 

1416+TEST1 EQU 

* 

0002 02 

1417+ 

DC 

X'02' STX 

0003 27 

l4l8+ 

DC 

X' 27 * ESC 

0004 F5 

1419+ 

1420 

1421++ 

1422 

DC 

X'F5’ ERASE WRITE 

MNOTE 59, OPERAND NO, 3, SUBOPERAND 4, YOU HAVE 
SPECIFIX ED RESET MODIFIED DATA TAGS ON AN ERASE 
WRITE 

OPERATION, WARNING 

*,WRITE CONTROL CHARACTER IS HEX 03 

0005 C3 

1423 + 

DC 

ALl(l95) ADDRESS, ATTRIBUTE OR WCC 

0006 11 

1424 + 

DC 

X'11' SBA 

1 

1425 


*,SBA BUFFER ADDRESS IS 37 DECIMAL 

tr 0007 40 

•1426 + 

DC 

ALl(64) ADDRESS, ATTRIBUTE OR WCC 

' 0008 E5 

1427 + 

DC 

AL1(229) ADDRESS, ATTRIBUTE OR WCC 

0009 ID 

1428+ 

1429 

DC 

X'ID' SF 

*,ATTRIBUTE CHARACTER IS HEX 28 

000A E8 

1430 + 

DC 

AL1(232) ADDRESS, ATTRIBUTE OR WCC 

OOOB C4C1E3C1 

1431 + 

DC 

CL4'DATA' 

000F 11 

1432 + 

1433 

DC 

X'll' SBA 

*,SBA BUFFER ADDRESS IS 45 DECIMAL 

0010 40 

1434 + 

DC 

ALl(64) ADDRESS, ATTRIBUTE OR WCC 

0011 6d 

1435- 

DC 

AL1U09) ADDRESS, ATTRIBUTE OR WCC 

0012 ID 

1436-^ 

1437 

DC 

X'ID' SF 

*,ATTRIBUTE CHARACTER IS HEX 00 

0013 40 

1438 + 

DC 

ALl{64) ADDRESS, ATTRIBUTE OR WCC 

0014 C4C1E3C140E6C8C9 

1439 + 

DC 

CL39'DATA WHICH IS QUITE LONG IS INTERESTING' 

003B 11 

1440 + 

1441 

DC 

X'll' SBA 

*,SBA BUFFER ADDRESS IS 100 DECIMAL 

003C Cl 

1442 + 

DC 

AL1(193) ADDRESS, ATTRIBUTE OR WCC 

003D E4 

1443 + 

DC 

AL1(228) ADDRESS, ATTRIBUTE OR WCC 

X'3C' RA 

*, RA BUFFER ADDRESS IS 151 DECIMAL 

003E 3C 

1444 + 

1445 

DC 

003F C2 

1446 + 

DC 

ALI(194) ADDRESS, ATTRIBUTE OR WCC 

0040 D7 

1447 + 

DC 

AL1(215) ADDRESS, ATTRIBUTE OR WCC 

f % f \ 

X J \ ) 

• * 



0041 

E7 

1448 + 

DC 

0042 

D9C5E2E3 

1449 + 

1450 

DC 

0046 

05 

1451 4 

DC 

0047 

C4C1E3C140E3D640 

1452 + 

1453 

DC 

0058 

11 

1454 + 

1455 

DC 

0059 

C2 

1456 + 

DC 

005A 

F9 

1457 4 

DC 

005B 

12 

1458 4 

1459 

DC 

005C 

C3 

l46o 4 

DC 

005D 

4F 

1461 4 

DC 

005E 

11 

1462 4 

1463 

DC 

005F 

C3 

1464 + 

DC 

0060 

F9 

1465 4 

DC 

0061 

13 

•1466 4 

1467 

DC 

0062 

ID 

1468 4 

1469 

DC 

0063 

40 

1470 4 

DC 

0064 

C4D6E4C2D3C540C4 

1471 4 

1472 

DC 

0072 

ID 

1473 4 

1474 

DC 

0073 

50 

1475 4 

DC 

0074 

11 

1476 4 

1477 

DC 

0075 

C4 

1478 4 

DC 

0076 

D2 

1479 4 

DC 

0077 

ID 

1480 4 

1481 

DC 

0078 

C8 

1482 4 

DC 

0079 

40E 3C8C 9E240C 9E2 

1483 4 

1484 

DC 


CLl'X' 

CL4'REST' 

MNOTE 57, OPERAND NO. 7, A PT HAS BEEN SPECIFIED 
WITHX AN ERASE WRITE, WARNING 
X'05' PT 

CL17'DATA TO BE TABBED' 

MNOTE 6l, OPERAND NO. 8, AN EUA HAS BEEN 
SPECIFIED WITHX AN ERASE WRITE, WARNING 
X'll' SBA 

*,SBA BUFFER ADDRESS IS 185 DECIMAL 
AL1(194) ADDRESS, ATTRIBUTE OR -WCC 
AL1(249) ADDRESS, ATTRIBUTE OR WCC 
X 1 12 1 EUA 

*,EUA BUFFER ADDRESS IS 207 DECIMAL 
AL1(195) ADDRESS, ATTRIBUTE OR WCC 
AL1(79) ADDRESS, ATTRIBUTE OR WCC 
X'll' SBA 

*,SBA BUFFER ADDRESS IS 249 DECIMAL 
ALl(195) ADDRESS, ATTRIBUTE OR WCC 
AL1(249) ADDRESS, ATTRIBUTE OR WCC 
X * 13 f IC 

*,MNOTE 55, SBA SEQUENCE AT 249, OMITTED 
X'ID 1 SF 

*,ATTRIBUTE CHARACTER IS HEX 00 
ALl(64) address, ATTRIBUTE OR WCC 
CL14'DOUBLE DEFAULT' 

*,MNOTE 55, SBA SEQUENCE AT 264, OMITTED 
X'ID' SF 

*,ATTRIBUTE CHARACTER IS HEX 10 
AL1(80) ADDRESS, ATTRIBUTE OR WCC 
X'll' SBA 

*,SBA BUFFER ADDRESS IS 274 DECIMAL 
AL1(196) ADDRESS, ATTRIBUTE OR WCC 
AL1(210) ADDRESS, ATTRIBUTE OR WCC 
X'ID' SF 

*,ATTRIBUTE CHARACTER IS HEX 08 
AL1(200) ADDRESS, ATTRIBUTE OR WCC 
CL23' THIS IS NEXT LINE TEST' 

MNOTE 56, OPERAND 12, SUBOPERAND 3, SELECTOR 
PEN DETECTX FIELD DOES NOT CONTAIN BLANKS OR 
NULLS IN LAST 



0090 03 


1485+* 
1486 


1487+ 

1488 

1489 

1490 


THREE POSITIONS, WARNING 
MNOTE 51, OPERAND NO. 12, SELECTOR PEN 
DETECT DATA FIEX LD EXTENDS FROM ONE ROW 
INTO NEXT, WARNING 
DC X'03’ etx 

*,STARTING ADDRESS 37, ENDING ADDRESS 297 
*,13 OPERANDS PROCESSED 

*,TOTAL CORE FOR FORMAT TEST1 WAS 143 BYTES 
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APPENDIX E, FORMAT MACRO INSTRUCTION MNOTE MESSAGES 

Numbered Mnotes 

MNOTE 1, NAME FIELD ON FORMAT MACRO MISSING, MACRO ABORT 

MNOTE 2, ZERO OPERANDS CODED, MACRO ABORT 

MNOTE 3, OPERAND NO. , IS NOT A SUBLIST, I.E., IN 
PARENTHESIS, MACRO ABSrT 

MNOTE 4, OPERAND NO. _, SPELLING ERROR DETECTED, MACRO ABORT 

MNOTE 5, OPERAND NO. _, SUBOPERAND NO. , INVALID ATTRIBUTE 

CHARACTER CODED NOT PNHISM OR A, MACRO ABSrT 

MNOTE 6, OPERAND NO. , SUBOPERAND NO. _, BOTH S AND I 

CODED IN ATTRIBUTE CHlMCTER, MACRO ABORT 

MNOTE 7, OPERAND NO. , SUBOPERAND NO. _, BOTH H AND I 

CODED IN ATTRIBUTE CHIrSCTER, MACRO ABORT 

MNOTE 8, OPERAND NO. , SUBOPERAND NO. , BOTH P AND N 

CODED IN ATTRIBUTE CHARACTER, USE A, MACROlBORT 

MNOTE 9, OPERAND NO. , HAS AN A AND A P IN THE ATTRIBUTE 
CHARACTER, MACRO ABORT 

MNOTE 10, OPERAND NO. , SUBOPERAND NO. , THE SUBOPERAND 

HAS GREATER THAN 6 CHARTERS FOR A SET BUFFER ADDRESS SEQUENCE, 
MACRO ABORT 

MNOTE 11, OPERAND NO. , SUBOPERAND NO. , ALL DIGITS ARE 

NOT NUMERIC FOR SCREENtOCATION, OR ARE NOT WITHIN AN ACCEPT¬ 
ABLE RANGE OF NUMERIC VALUES FOR THE SCREEN SIZE SPECIFIED, 

MACRO ABORT 

MNOTE 12, OPERAND NO. , SUBOPERAND NO. , WHEN UTILIZING 

ROW-AND-COLUMN NOTATION EITHER THE 3RD OR 4TH CHARACTER MUST 
BE A C 

MNOTE 13, OPERAND NO. , SUBOPERAND NO. , FOR A SCREEN 

SIZE OF 1920, THE ROW NUMBER MUST BE, IF TWO - POSITIONS LONG, 
GREATER THAN 9 AND LESS THAN 25, OR IF A 480 SIZE SCREEN 
GREATER THAN 9 AND LESS THAN 13, ABORT 

MNOTE 14, OPERAND NO. _, SUBOPERAND NO. _, FOR A SCREEN 

SIZE OF 1920, THE COLUMN NUMBER MUST BE GREATER THAN OR EQUAL 
TO 1 AND LESS THAN 8l OR IF A 480 SIZE SCREEN GREATER THAN OR 
EQUAL TO ONE AND LESS THAN 4l MACRO ABORT 

MNOTE 15, OPERAND NO. , SUBOPERAND NO. , IF A SINGLE 

POSITION ROW NUMBER IS - ST r ECIFIED, IT MUST BE GREATER THAN 0 
AND LESS THAN 10, MACRO ABORT 
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MNOTE l6, OPERAND NO. , SUBOPERAND NO. _, THE SCREEN SIZE 

OF 480 OR 1920 HAS BEElTfXCEEDED, THE MAXIMUM VALUE AS CAL¬ 
CULATED MUST BE 479 OR 1919, ABORT 

MNOTE 17, OPERAND NO. , SUBOPERAND NO. , THE CALCULATED 

ADDRESS IS EQUAL TO THETFREVIOUS BUFFER LOCATION, OPERANDS 
MUST NOT OVERLAP, MACRO ABORT 

MNOTE 18, OPERAND NO. , SUBOPERAND NO. , AN ILLEGAL WRAP 

OPERATION HAS OCCURREDlN THAT THE ORIGINAirETARTING SCREEN 
LOCATION FOR THIS SCREEN HAS NOW BEEN REACHED AFTER WRAPING 
THE SCREEN ONCE, MACRO ABORT 

MNOTE 19, OPERAND NO. , SUBOPERAND NO. , YOU HAVE ALREADY 

WRAPPED ONCE AND ARE NOWATTEMPTING TO WRAFlGAIN, MACRO ABORT 

MNOTE 20, OPERAND NO. , SUBOPERAND , A WRAP OPERATION HAS 

JUST OCCURRED BUT HAS EXCEEDED THE START - ADDRESS FOR THIS 
SCREEN, MACRO ABORT 

MNOTE 21, OPERAND NO. , THE 3RD SUBOPERAND HAS BEEN OMITTED 
WHICH REQUIRES A 4TH SUBOPERAND, MACRO ABORT 

MNOTE 22, OPERAND NO. , SUBOPERAND , THE 3RD SUBOPERAND 

CONTAINING DATA MUST BEGIN AND END IN OIlGLE QUOTATION MARKS, 
MACRO ABORT 

MNOTE 23, OPERAND NO. , SUBOPERAND , YOU HAVE OMITTED A 

SET BUFFER ADDRESS SEQUENCE IN THE SUBOFfRAND AND HAVE NOT 
SPECIFIED AN ERASE WRITE. A WRITE MUST BEGIN WITH A SBA 
SEQUENCE, MACRO ABORT. 

MNOTE 24, OPERAND NO. _, YOU HAVE SPECIFIED SELECTOR PEN 

DETECT BUT HAVE OMITTED THE 3RD SUBOPERAND, MACRO ABORT 

MNOTE 23, OPERAND NO. , THE 4TH SUBOPERAND DOES NOT HAVE A 
DECIMAL NUMBER IN IT, WORO ABORT 

MNOTE 26, OPERAND _, SUBOPERAND , THE FIRST CHARACTER OF 

A SELECTOR PEN DETECT FIELD MUST CONTAIN A BLANK, GREATER THAN, 
NULL OR QUESTION MARK, MACRO ABORT 

MNOTE 27, OPERAND , SUBOPERAND , SELECTOR PEN DETECT 

FIELD IS NOT 2 CHARACTERS WIDE, MACRO" ABORT 

MNOTE 28, OPERAND _, SUBOPERAND , SELECTOR PEN DETECT 

FIELD MAY NOT BE LIME ENOUGH, WARNING 

MNOTE 29, OPERAND , SUBOPERAND , AN ERASE WRITE WAS NOT 

SPECIFIED YET A 4TH SUBOPERAND WAS - O0DED GIVING FIELD LENGTH 
FOR A SELECTOR PEN DETECT FIELD, WARNING 

MNOTE 30, OPERAND WAS CODED RA AND HAS LESS THAN 4 SUB¬ 
OPERANDS, MACRO ABORT 



MNOTE 31, OPERAND , WAS CODED RA AND HAS AN OMITTED 3RD 
SUBOPERAND, MACRO IECRT 

MNOTE 32, OPERAND , WAS CODED RA AND HAS AN OMITTED 4TH 
SUBOPERAND, MACRO IS$RT 

MNOTE 33, OPERAND , SUBOPERAND _, REQUIRES A SINGLE 

CHARACTER, MACRO ABSRT . 

MNOTE 34, OPERAND NO. _, AN EUA OPERAND MUST HAVE THREE 

SUBOPERANDS, MACRO ABORT - 

MNOTE 35, OPERAND NO. , AN EUA OPERAND MUST NOT HAVE AN 
OMITTED 3RD SUBOPERAND, MACRO ABORT 

MNOTE 36, OPERAND NO. _, A PT OPERAND MUST HAVE 3 SUBOPERANDS, 

MACRO ABORT 

MNOTE 37, OPERAND NO. , A PT OPERAND CANNOT HAVE A SECOND 
SUBOPERAND MISSING, MACR^ ABORT 

MNOTE 38, OPERAND NO. _, A PT OPERAND CANNOT HAVE A THIRD 

SUBOPERAND MISSING, MACRO ABORT 

MNOTE 39, OPERAND NO. , AN EM HAS BEEN SPECIFIED AS A SINGLE 
SUBOPERAND WITHOUT SPECIFYING A PRINTER AS A DEVICE, WARNING 

MNOTE 40, OPERAND NO. , A NL HAS BEEN SPECIFIED AS A SINGLE 
SUBOPERAND WITHOUT SPECIFYING A PRINTER AS A DEVICE, WARNING 

MNOTE 41, OPERAND NO. _, AN IC HAS BEEN SPECIFIED AS A SUB¬ 

OPERAND AND IS MISSING A REQUIRED 2ND SUBOPERAND, MACRO ABORT 

MNOTE 42, OPERAND NO. , A STX HAS BEEN CODED AS A SINGLE 
SUBOPERAND YET A REMOTE-DEVICE WAS NOT SPECIFIED MACRO ABORT 

MNOTE 43, OPERAND NO. _, AN ETX HAS BEEN CODED AS A SINGLE 

SUBOPERAND YET A REMOTE DEVICE WAS NOT SPECIFIED, MACRO ABORT 

MNOTE 44, OPERAND NO. ,AN ESC HAS BEEN CODED YET A REMOTE 

DEVICE WAS NOT SPECIFIER MACRO ABORT 

MNOTE 45, OPERAND NO. , SUBOPERAND , AN ESC OPERAND RE¬ 
QUIRES AN E OR EW IN THE SECOND SUBOPERAND LOCATION, MACRO 

ABORT 

MNOTE 46, OPERAND NO. , AN ESC OPERAND REQUIRES 3 OR MORE 
SUBOPERANDS, MACRO ABORT - 

MNOTE 47, OPERAND NO. , SUBOPERAND , AN INVALID SUB¬ 
OPERAND, OTHER THAN A, NL, 40, 64, 80 ,~SF, RR OR MDT HAS 

BEEN DETECTED, MACRO ABORT 
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MNOTE 48, OPERAND NO. , SUBOPERAND , A DUPLICATE PRINTER 
CODE HAS BEEN SPECIFIED7"”I .E., IF A 4oHS ALREADY BEEN SET, A 
64, NL, OR 80 HAS BEEN DETECTED MACRO ABORT 

MNOTE 49, OPERAND NO. , CODED WCC YET A REMOTE CONFIGURA¬ 
TION WAS SPECIFIED, MACRO - ABORT 

MNOTE 50, OPERAND NO. , SUBOPERAND _, WCC CODED AND DOES 

NOT HAVE AN EW OR W IN THE 2ND SUBOPERAND, MACRO ABORT 

MNOTE 51, OPERAND NO. , SELECTOR PEN DETECT DATA FIELD EX¬ 
TENDS FROM ONE ROW INTUTIEXT, WARNING 

MNOTE 52, OPERAND NO. , A GREATER THAN HAS BEEN SPECIFIED 
AS THE FIRST CHARACTERIN' A SELECTOR PEN DETECT FIELD YET NO 
MODIFIED DATA TAG HAS BEEN SET IN THE ATTRIBUTE CHARACTER, 

WARNING 

MNOTE 53, OPERAND NO. _, A GREATER THAN HAS NOT BEEN SET IN THE 

FIRST CHARACTER OF A SELECTOR PEN DETECT FIELD YET THE MODIFIED 
DATA TAG HAS BEEN SET, WARNING 

MNOTE 54, OPERAND , AN IC OPERAND, HAS BEEN CODED WITH 3 
SUBOPERANDS YET THE FIRST CHARACTER OF THE 3RD SUBOPERAND IS 
NOT AN X, MACRO ABORT 

MNOTE 55, SBA SEQUENCE AT _, OMITTED 

MNOTE 56, OPERAND , SUBOPERAND , SELECTOR PEN DETECT 
FIELD DOES NOT CONTSTN BLANKS OR NULLS IN LAST THREE POSI¬ 
TIONS, WARNING 

MNOTE 57, OPERAND NO. , A PT HAS BEEN SPECIFIED WITH AN 
ERASE WRITE, WARNING 

MNOTE 58, OPERAND NO. , SUBOPERAND NO. , HAS BOTH AN A AND 

N IN THE ATTRIBUTE CHARTTOTER, MACRO ABORT “~ 

MNOTE 59, OPERAND NO. , SUBOPERAND NO. , HAS SPECIFIED 

RESET MODIFIED DATA TAGS” - ON AN ERASE WRITETJPERATION, WARNING 

MNOTE 60, OPERAND NO. _, SUBOPERAND NO. , HAS SPECIFIED A 

RESTORE KEYBOARD FOR ATrINTER DEVICE, WARFIFG 

MNOTE 6l, OPERAND NO. , AN EUA HAS BEEN SPECIFIED WITH AN 
ERASE WRITE, WARNING 


Unnumbered Mnotes 
MNOTE FOR ATTRIBUTE CHARACTER 
*,ATTRIBUTE CHARACTER IS HEX XX 
MNOTE FOR WRITE CONTROL CHARACTER 
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*,WRITE CONTROL CHARACTER IS HEX XX 
MNOTE FOR SBA BUFFER ADDRESSES 

*,SBA BUFFER ADDRESS IS _DECIMAL 

ENDING MNOTES 

*, STARTING ADDRESS _ENDING ADDRESS __ 

*, _ OPERANDS PROCESSED 

*, TOTAL CORE FOR FORMAT ___ WAS _ BYTES 

*,WRAP OCCURRED 




APPENDIX F, "MNOTES FOR SBA SEQUENCES - DISCUSSION” 


The largest string of characters for an SBA sequence is 
6, i.e., R21C72. If a sequence of larger than 6 Is detected, 
mnote 10 aborts the expansion. If the first character is not 
an R, a numeric operand is assumed and each character is 
checked to see that it is numeric. Mnote 11 results if all 
characters are not numeric. If the first character Is an R 
then the third or fourth characters must be C. Failure to 
pass this test causes mnote 12. Each row and column number 
is checked for a proper numeric range and if not correct, 
mnote 11 is used to abort Macro expansion. The row number 
and column number is checked against valid ranges based on the 
buffer size and mnotes 13, l4 & 15 document errors detected 
at this point. The final decimal number is next calculated 
from row and column notation or from the decimal number, 
whichever is specified, and checked against the screen size. 

An error in an invalid decimal number specification at this 
point, i.e., specifying 482 for a model 1 screen, will cause 
Macro abort with mnote 16 , This same sequence of checks is 
done for all addresses in all types of operands. 
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APPENDIX G, "MNOTES IN CONJUNCTION WITH ILLEGAL WRAP OPERATIONS - 

....DISCUSSION"- - 


When FORMAT puts data, NL or EM in the output data stream 
or an attribute character or when a 4th operand is specified 
as to field length, FORMAT increases its internal buffer 
address by the appropriate amount. FORMAT also keeps track 
of the starting address and ending address in the buffer and 
whether or not wrap has occurred. If a calculated address 
is equal to the previous buffer address as maintained by FORMAT, 
mnote 17 results. Exception is made for Repeat to Address 
orders used for filling an entire buffer with the same charac¬ 
ter and Erase Unprotected to Address orders used for erasing 
all unprotected data in the buffer. If wrap has already occurred 
and the current operand exceeds FORMAT'S starting address then 
Macro abort occurs with mnote 18. If wrap has already occurred 
and the current operand is causing a second wrap, mnote 19 will 
abort Macro expansion. Finally, if the current operation causes 
a wrap to occur and if it exceeds the starting address of the 
screen, mnote 20 will abort expansion. The following two pages 
illustrate these 4 situations with test data. The erase write 
and write operands have been omitted in the four test cases. 

If CHECKING=N0 is specified, as outlined in Appendix I, 

Macro Abort cannot occur due to Mnotes 17, 18 , 19 or 20. 
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3014 T97 

FORMAT 

3015+T97 

EQU 

3016+ 

DC 

3017 


3018+ 

DC 

3019+ 

DC 

3020+ 

DC 

3021 


3022+ 

DC 

3023+ 

DC 

3024 + 

DC 

3023 


3026 + 

DC 

3027 + 

DC 

3028 + 

DC 

3029 


3030 + 

DC 

3031 


3032+* 



1802 Tl8 

FORMAT 

1803+T18 

EQU 

1804 + 

DC 

1805 


1806 + 

DC 

1807 + 

DC 

1808 + 

DC 

1809 


1810 + 

DC 

1811 + 

DC 

1812 + 

DC 

1813 


l8l4 + 

DC 

l8l5 + 

DC 

1816 + 

DC 

1817 


1818+ 

DC 

1819 + 

DC 

1820 


1821 +* 


1822 +* 



(N,R2C2,'DATA'),(N,R2C6,'D') 

* 

X'll' SBA 

*,SBA BUFFER ADDRESS IS 8l DECIMAL 
AL1(193) ADDRESS, ATTRIBUTE OR WCC 

AL1(209) ADDRESS, ATTRIBUTE OR WCC 

X'ID* SF 

*,ATTRIBUTE CHARACTER IS HEX 10 
ALl(80) ADDRESS, ATTRIBUTE OR WCC 
CL4'DATA' 

X'll’ SBA 

*,SBA BUFFER ADDRESS IS 85 DECIMAL 
AL1(193) ADDRESS, ATTRIBUTE OR WCC 

AL1(213) ADDRESS, ATTRIBUTE OR WCC 

X'lD' SF 

*,ATTRIBUTE CHARACTER IS HEX 10 
ALl(80) ADDRESS, ATTRIBUTE OR WCC 
MNOTE 17, OPERAND NO. 2, SUBOPERAND 
NO. 2, THE CALCULATED ADDRESS IS 
EQUAL TO THE PREVIOUS BUFFER 
LOCATION, OPERANDS MUST NOT OVERLAP, 
MACRO ABORT 


(,R1C3, f 0'),(N,R1C2,'Y') 

* 

X'll' SBA 

*,SBA BUFFER ADDRESS IS 2 DECIMAL 
AL1(64) ADDRESS, ATTRIBUTE OR WCC 
AL1(194) ADDRESS, ATTRIBUTE OR WCC 
X'lD' SF 

*,ATTRIBUTE CHARACTER IS HEX 00 
ALl(64) ADDRESS, ATTRIBUTE OR WCC 
CL1'0 * 

X'll' SBA 

*,SBA BUFFER ADDRESS IS 1 DECIMAL 
AL1(64) ADDRESS, ATTRIBUTE OR WCC 
AL1(193) ADDRESS, ATTRIBUTE OR WCC 
X'lD' SF 

*,ATTRIBUTE CHARACTER IS HEX 10 
AL1(80) ADDRESS, ATTRIBUTE OR WCC 
Clx 3 Y f 

MNOTE 18, OPERAND NO. 2, SUBOPERAND 
NO. 3 , AN ILLEGAL WRAP OPERATION HAS 
OCCURRED IN THAT THE ORIGINAL START¬ 
ING SCREEN LOCATION FOR THIS SCREEN 
HAS NOW BEEN REACHED AFTER WRAPING THE 
SCREEN ONCE, MACRO ABORT 
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1414 T60 

FORMAT 

l4i3fT60 

EQU 

l4l6f 

DC 

1417 


I4l8+ 

DC 

l4l9 f 

DC 

1420+ 

DC 

1421 


1422+ 

DC 

1423+ 

DC 

1424+ 

DC 

1425 


1426+ 

DC 

1427+ 

DC 

1428+ 

DC 

1429 


1430+ 

DC 

1431 


1432 +* 



2561 T78 

FORMAT 

2562+T78 

EQU 

2563+ 

DC 

2564 


2565+ 

DC 

2566+ 

DC 

2567 + 

DC 

2568 


2569+ 

DC 

2570 + 

DC 

2571 + 

DC 

2572 


2573 + 

DC 

2574 + 

DC 

2575 + 

DC 

2576 


2577 + 

DC 

2578 


2579+* 



(N,R12C35>'DATA',20),(N,R1C4,'DATA 1 ) 
* 

X'll’ SBA 

*,SBA BUFFER ADDRESS IS 474 DECIMAL 

AL1(199) address, attribute or wcc 
AL1(90) ADDRESS, attribute or wcc 
X'lD' SF 

*,attribute character is HEX 10 
ALl(8o) ADDRESS, ATTRIBUTE OR WCC 
CL4 'DATA' 

X'll' SBA 

*,SBA BUFFER ADDRESS IS 3 DECIMAL 
ALl(64) ADDRESS, ATTRIBUTE OR WCC 
ALl(195) ADDRESS, ATTRIBUTE OR WCC 
X'lD' SF 

*,ATTRIBUTE CHARACTER IS HEX 10 
ALl(80) ADDRESS, ATTRIBUTE OR WCC 
MNOTE 19, OPERAND NO. 2, SUBOPERAND 
NO. 2, YOU HAVE ALREADY WRAPPED 
ONCE AND ARE NOW ATTEMPTING TO 
WRAP AGAIN, MACRO ABORT 


(,R5C5,'D'),(,R5C5,'D*) 

* 

X'll' SBA 

*,SBA BUFFER ADDRESS IS 324 DECIMAL 
AL1(197) ADDRESS, ATTRIBUTE OR WCC 
AL1(196) ADDRESS, ATTRIBUTE OR WCC 
X'lD' SF 

*,ATTRIBUTE CHARACTER IS HEX 00 
ALl(64) ADDRESS, ATTRIBUTE OR WCC 
CLl'D' 

X'll' SBA 

*,SBA BUFFER ADDRESS IS 324 DECIMAL 
AL1(197) ADDRESS, ATTRIBUTE OR WCC 
ALl(l96) ADDRESS, ATTRIBUTE OR WCC 
X'lD' SF 

*,ATTRIBUTE CHARACTER IS HEX 00 
AL1(64) ADDRESS, ATTRIBUTE OR WCC 
MNOTE 20, OPERAND NO. 2, SUBOPERAND 
2, A WRAP OPERATION HAS JUST OCCURRED 
BUT HAS EXCEEDED THE START 
ADDRESS FOR THIS SCREEN, MACRO ABORT 
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APPENDIX H - INCLUDING LABELS IN A FORMAT OUTPUT DATA STREAM 


The Programmer can create a label anywhere In the Output 
Data Stream by coding a label operand wherever he desires. 
The label operand Is a single label enclosed In parenthesis 
and beginning with a dollar sign. Thus ($HERE) will gen¬ 
erate: 

$HERE EOU * 

If the label operand preceded a basic operand that had a 
leading SBA sequence as well as a Start Field Order then 
the following offsets would be applicable: 


Address 

Offset to: 

$HERE 

SBA Order 

$HERE+1 

SBA Address 

$HERE+3 

Start Field Order 

$HERE+4 

Attribute Character 

$HERE+5 

1st byte of Output Data 




APPENDIX I - USING THE CHECKINQ=?NO OPERAND 


If you do not desire FORMAT to check the ascending sequence 
of operands, you may code (CHECKING**NO) anywhere in the se¬ 
quence of operands. As a result, FORMAT will not Abort with 
MNOTES 17 thru 20 as per Appendix G. FORMAT will refrain from 
any further checking until you code (CHECKING=YES). If the 
first use of FORMAT utilizes (CHECKING“NO) then it is neces¬ 
sary to code (CHECKING*YES) as the first operand of the next 
use of FORMAT if you desire checking to start again for that 
screen. 

If you desire to add several fields to the end of a set of 
existing FORMAT macro operands, by removing the (ETX) operand 
and substituting (CHECKING=N0), you may now code any number of 
additional operands in any order without creating an Abort 
condition. Following the last of the added operands you would 
then code the (ETX) operand. 
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